Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .github/workflows/validate-versions.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
name: Validate versions

on:
pull_request:
push:

permissions:
contents: read

jobs:
versions:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- name: Check repository and skill versions
run: sh scripts/check_versions.sh
16 changes: 12 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,14 +76,20 @@ tags:
|-------|----------|-------------|
| `name` | ✅ | Human-readable skill name |
| `description` | ✅ | Brief description (1-2 sentences) |
| `version` | ✅ | Semantic version (e.g., 1.0.0) |
| `version` | ✅ | Repository release version from the root `VERSION` file |
| `dependencies` | ⚠️ | List of required tools/servers (e.g., mcp-server-tron) |
| `tags` | ⚠️ | Searchable tags for skill discovery |

---

## 🗂 Skill Directory Structure

### Versioning

All skills are released together and must use the exact version in the root `VERSION` file. Skill
versions do not track their external CLI or SDK dependencies. See [VERSIONING.md](./VERSIONING.md)
and run `sh scripts/check_versions.sh` after changing a version.

### Required Files

- **SKILL.md** - Main skill definition (required)
Expand Down Expand Up @@ -119,7 +125,7 @@ cat > skills/my-skill/SKILL.md << 'EOF'
---
name: My Skill
description: What this skill does
version: 1.0.0
version: <value from root VERSION>
tags:
- category
---
Expand Down Expand Up @@ -240,6 +246,7 @@ tags:
### Manual Testing Checklist

- [ ] SKILL.md has valid YAML frontmatter
- [ ] SKILL.md version matches the root VERSION file
- [ ] All dependencies are documented
- [ ] Instructions are clear and step-by-step
- [ ] Examples run without errors
Expand Down Expand Up @@ -350,7 +357,8 @@ Future skills to consider:
A: Yes, list it in `dependencies` and reference it in instructions.

### Q: How do I version a skill?
A: Use semantic versioning (MAJOR.MINOR.PATCH) in frontmatter.
A: Use the repository release in the root `VERSION` file. All skills advance together; dependency
versions remain independent.

### Q: Can I use external APIs in a skill?
A: Yes, but document them clearly in prerequisites.
Expand All @@ -369,5 +377,5 @@ A: Use resource files (JSON) with network-specific configs.

---

**Last Updated**: 2026-02-09
**Last Updated**: 2026-08-26
**Maintainer**: Bank of AI Team
20 changes: 20 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,25 @@
# Changelog

## [2.0.0] - 2026-08-26

### Breaking Changes

- Removed `multisig-permissions`, `trc20-toolkit-skill`, `trx-staking-skill`, `twitter-digest`, and
`twitter-mcp`. Generic TRON workflows are now handled by `wallet-cli`; X/Twitter workflows no
longer belong to this DeFi-focused Skills collection.
- Unified every retained Skill version with the repository release version.

### Features

- Added the `wallet-cli` skill for machine-readable TRON wallet, transfer, staking, governance,
contract, signing, permission, and chain-query operations.
- Added a root version source, repository versioning policy, and CI consistency check.

### Security

- Preserved exact-token-approval, staking/unfreezing, voting, and permission-lockout guidance in
the consolidated `wallet-cli` safety reference.

## [1.5.9] - 2026-07-09

### Improvements
Expand Down
9 changes: 3 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,9 @@ A curated collection of practical, DeFi-focused utility skills developed by the

BANK OF AI Skills are reusable, task-oriented capabilities that teach AI agents how to perform specific blockchain workflows. Each skill encapsulates domain knowledge (like SunSwap pathfinding) and provides step-by-step instructions for the agent to follow.

All skills share the repository release version in [`VERSION`](./VERSION). External CLI and SDK
versions remain independent dependencies. See [`VERSIONING.md`](./VERSIONING.md) for the policy.

## Installation

Use the standard installer and follow the `npx` prompts to select the skills you want and the agentic platform you use. This installs the selected Skill definitions but does not install their external CLI dependencies.
Expand Down Expand Up @@ -78,13 +81,10 @@ Some skills require wallet signature operations and are built on Agent Wallet. B
### Security & Permissions

- [**agent-wallet**](./agent-wallet) - Wallet management and signing skill for creating wallets, switching active wallets, resolving addresses, and signing transactions or messages on EVM and TRON. See [README](./agent-wallet/README.md).
- [**multisig-permissions**](./multisig-permissions) - TRON native account permission and multi-signature workflow skill. Supports permission inspection, template-based updates, proposal creation, co-signing, review, and execution. See [README](./multisig-permissions/README.md).

### Data & Analytics

- [**tronscan-skill**](./tronscan-skill) - Comprehensive TRON blockchain data lookup via TronScan API. Supports accounts, transactions, tokens, blocks, and network-wide statistics. See [README](./tronscan-skill/README.md).
- [**trc20-toolkit-skill**](./trc20-toolkit-skill) - Universal TRC20 token toolkit for TRON. Supports metadata lookup, balance checks, transfers, and allowance management. See [README](./trc20-toolkit-skill/README.md).
- [**trx-staking-skill**](./trx-staking-skill) - TRX staking workflow skill for Tron Power, vote delegation, reward queries, and SR operations. See [README](./trx-staking-skill/README.md).
- [**usdd-skill**](./usdd-skill) - USDD toolkit for balance checks, PSM inspection, swaps, and vault information. See [README](./usdd-skill/README.md).

### Guides & Onboarding
Expand All @@ -97,13 +97,10 @@ Each current skill now has its own README for quick discovery:

- [agent-wallet/README.md](./agent-wallet/README.md)
- [bankofai-guide/README.md](./bankofai-guide/README.md)
- [multisig-permissions/README.md](./multisig-permissions/README.md)
- [recharge-skill/README.md](./recharge-skill/README.md)
- [sunperp-skill/README.md](./sunperp-skill/README.md)
- [sunswap/README.md](./sunswap/README.md)
- [trc20-toolkit-skill/README.md](./trc20-toolkit-skill/README.md)
- [tronscan-skill/README.md](./tronscan-skill/README.md)
- [trx-staking-skill/README.md](./trx-staking-skill/README.md)
- [usdd-skill/README.md](./usdd-skill/README.md)
- [wallet-cli/README.md](./wallet-cli/README.md)
- [x402-payment/README.md](./x402-payment/README.md)
Expand Down
1 change: 1 addition & 0 deletions VERSION
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
2.0.0
49 changes: 49 additions & 0 deletions VERSIONING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Versioning

This repository uses one release version for the complete Skills collection.

## Source of truth

The root [`VERSION`](./VERSION) file is the source of truth. Its value uses Semantic Versioning
without a leading `v`.

The same version must appear in:

- every top-level `*/SKILL.md` frontmatter `version` field;
- every top-level skill `package.json` that declares a version;
- the newest entry in `CHANGELOG.md`.

Release tags add the conventional prefix: version `2.0.0` is tagged `v2.0.0`. Do not create
independent per-skill release tags. A change to any skill is released as a new repository version,
and all skill frontmatter versions advance together even when a particular skill did not change.

## Dependency versions

External CLI, SDK, runtime, and service versions are independent of the repository release. Keep
them in each skill's `dependencies`, prerequisites, and installer. Financial execution CLIs should
normally use an exact tested version; use a range only when the skill intentionally supports and
tests that complete range.

For example:

```yaml
version: 2.0.0
dependencies:
- "@tron-walletcli/wallet-cli@4.12.0"
```

Here `2.0.0` is the BofAI Skills release and `4.12.0` is the independently maintained CLI version.

## Release rules

- Patch: documentation corrections and backward-compatible fixes.
- Minor: backward-compatible skill additions or workflow improvements.
- Major: removed skills, renamed skills, incompatible trigger or workflow changes, or changed
authorization/security contracts.

Before opening a release, update `VERSION`, all skill and package mirrors, and `CHANGELOG.md`, then
run:

```bash
sh scripts/check_versions.sh
```
1 change: 1 addition & 0 deletions agent-wallet/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
name: agent-wallet
description: 'Use when the user asks to create a wallet, check wallet addresses, sign transactions or messages, switch active wallets, or perform any blockchain signing operation using the agent-wallet CLI. Supports EVM and TRON networks.'
version: 2.0.0
compatibility: Requires Node.js 20+.
metadata:
author: BofAI
Expand Down
2 changes: 1 addition & 1 deletion bankofai-guide/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: bankofai-guide
description: "Onboarding guide for BofAI skills — handles post-install setup, AgentWallet creation, and wallet guard when no wallet is configured."
version: 1.0.0
version: 2.0.0
tags:
- bankofai
- onboarding
Expand Down
2 changes: 0 additions & 2 deletions multisig-permissions/.gitignore

This file was deleted.

Loading
Loading