<h1 align="center">BANK OF AI Skills</h1>
<p align="center">
<a href="https://github.com/BofAI/skills">
<img src="https://img.shields.io/badge/GitHub-BofAI%2Fskills-blue" alt="GitHub" />
</a>
<a href="./LICENSE">
<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" />
</a>
</p>
A curated collection of practical, DeFi-focused utility skills developed by the **BANK OF AI team**. These skills enable AI agents to manage wallets, use DeFi protocols, and query blockchain data on TRON and supported EVM networks.
> **Project Positioning:** We focus on delivering high-value DeFi utility skills that are platform-agnostic. These skills provide the domain knowledge needed to interact with the TRON blockchain and beyond.
---
## Contents
- [What are BANK OF AI Skills?](#what-are-bank-of-ai-skills)
- [Installation](#installation)
- [Wallet and Credentials](#wallet-and-credentials)
- [Available Skills](#available-skills)
- [Wallet & TRON](#wallet--tron)
- [DeFi & DEX](#defi--dex)
- [Data & Analytics](#data--analytics)
- [Skill Docs](#skill-docs)
- [Usage Tips](#usage-tips)
- [Explicit Invocation](#explicit-invocation)
- [Implicit Triggering](#implicit-triggering)
- [Creating Skills](#creating-skills)
- [Contributing](#contributing)
- [License](#license)
---
## What are BANK OF AI Skills?
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 stable `main` branch 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.
```bash
npx skills add https://github.com/BofAI/skills/tree/main
```
The default development branch may contain unreleased changes. Use it only for intentional testing:
```bash
npx skills add https://github.com/BofAI/skills/tree/develop
```
See [BRANCHING.md](./BRANCHING.md) for the development, release, and hotfix workflow.
### Wallet and Credentials
Use the [wallet-cli Skill](./wallet-cli/README.md) for official wallet setup and operations through
`@tron-walletcli/wallet-cli@4.14.0`. Configure accounts locally; do not send private keys,
mnemonics, or passwords through chat.
Other Skills retain their actual execution and credential requirements:
- SunSwap and SunPump use `sun-cli`; configure its supported wallet source for transactions.
Read-only queries and supported dry-run previews do not require a wallet.
- SunPerp public market queries require no credentials; private API calls use SunPerp API keys,
and withdrawals additionally require the signing key described in that Skill.
- USDD and TronScan follow their own documented signing and API-key requirements.
Installing a Skill does not configure these credentials, and wallet-cli accounts are not
implicitly shared with other tools. There is no collection-wide wallet prerequisite.
---
## Available Skills
### Wallet & TRON
- [**wallet-cli**](./wallet-cli) - Safe, machine-readable TRON wallet operations through `@tron-walletcli/wallet-cli@4.14.0`, including accounts, transfers, staking, governance, contracts, signing, and chain queries. See [README](./wallet-cli/README.md).
### DeFi & DEX
- [**sunswap**](./sunswap) - SunSwap DEX integration for TRON via `sun-cli`. Supports price quotes, token swaps, liquidity and pool operations. See [README](./sunswap/README.md).
- [**sunperp-skill**](./sunperp-skill) - SunPerp perpetual futures trading skill for TRON. Supports market data, account queries, order placement, and position management. See [README](./sunperp-skill/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).
- [**usdd-skill**](./usdd-skill) - USDD toolkit for balance checks, PSM inspection, swaps, and vault information. See [README](./usdd-skill/README.md).
### Skill Docs
Each current skill now has its own README for quick discovery:
- [sunperp-skill/README.md](./sunperp-skill/README.md)
- [sunswap/README.md](./sunswap/README.md)
- [tronscan-skill/README.md](./tronscan-skill/README.md)
- [usdd-skill/README.md](./usdd-skill/README.md)
- [wallet-cli/README.md](./wallet-cli/README.md)
---
## Usage Tips
When using BANK OF AI Skills, you can choose between different invocation patterns depending on your needs.
### Explicit Invocation
When you know exactly which skill is required for a task, direct the Agent to read that specific skill file.
**Best for:**
- Clear task objectives
- Deterministic execution paths
- Debugging complex workflows
**Example:**
> "Please read `skills/sunswap/SKILL.md` and check how much TRX I can get for 100 USDT on SunSwap."
### Implicit Triggering
If the skills are already within the agent's context or indexed, simply describe your goal and let the Agent match the most appropriate skill.
**Best for:**
- Natural language interactions
- Pre-loaded skills in the Agent's context
- Letting the Agent determine the optimal path
**Example:**
> "Check the current exchange rate for 100 USDT to TRX on SunSwap."
---
## Creating Skills
We follow a strict standard to ensure skills are effective and safe. Please read [**AGENTS.md**](./AGENTS.md) before contributing.
A standard skill directory includes:
- `SKILL.md`: The core instruction set.
- `examples/`: Runnable usage examples.
- `resources/`: ABIs, constants, and config files.
## Contributing
We welcome contributions from the community! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for our workflow.
## License
This repository is licensed under the [MIT License](./LICENSE).
---
<p align="center">
<b>Built with ❤️ by Team BANK OF AI</b><br>
<i>Empowering AI Agents with DeFi Capabilities</i>
</p>