# Agent Skills

WDK provides agent skills: structured instruction sets that teach AI agents how to create wallets, send transactions, swap tokens, bridge assets, and interact with DeFi protocols across 20+ blockchains. All operations are self-custodial. Keys stay on your machine, with no third-party custody dependency.

{% hint style="info" %}
**Skill vs MCP Toolkit**: Use an **agent skill** when your agent platform works with file-based instructions (e.g., OpenClaw, Cursor). Use the [MCP Toolkit](https://docs.wdk.tether.io/ai/mcp-toolkit) when your agent supports the Model Context Protocol natively (e.g., Claude, Cursor). Use both for maximum coverage.
{% endhint %}

## What Are Agent Skills?

An agent skill is a structured set of instructions and reference documentation that teaches an AI agent to use a specific tool or SDK. Skills follow the [AgentSkills specification](https://agentskills.io/specification). Each skill is a `SKILL.md` file with frontmatter metadata and detailed instructions that any compatible agent can load and execute.

WDK publishes a skill that covers the full SDK surface: wallet modules, swap, bridge, lending, fiat on/off-ramps, and the indexer. When an agent loads the skill, it learns WDK's APIs so you don't need blockchain expertise to get started. You can view the full skill file on [GitHub](https://github.com/tetherto/wdk-docs/blob/main/skills/wdk/SKILL.md).

## Capabilities

Once an agent loads the WDK skill, it can:

| Category         | Operations                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Wallets**      | Create and recover wallets across EVM chains, Bitcoin, Solana, Spark, TON, and Tron                                |
| **Transactions** | Send native tokens and token transfers (ERC-20, SPL, Jetton, TRC-20)                                               |
| **Swaps**        | DEX swaps via Velora (EVM) and StonFi (TON)                                                                        |
| **Bridges**      | Cross-chain bridges with USDT0 via LayerZero                                                                       |
| **Lending**      | Supply, borrow, repay, and withdraw via Aave V3                                                                    |
| **Fiat**         | Buy and sell crypto via MoonPay on/off-ramps                                                                       |
| **Gasless**      | Fee-free transfers on TON (via paymaster) and Tron (via gas-free service), and ERC-4337 account abstraction on EVM |

{% hint style="warning" %}
All write operations require explicit human confirmation. The skill instructs agents to estimate fees before sending and includes prompt injection protection guidance.
{% endhint %}

## How It Works

1. **Install the skill** by running `npx skills add tetherto/wdk-agent-skills` and selecting the agent you prefer
2. **Agent loads the skill** and reads `SKILL.md` along with per-module reference files to learn WDK's API surface
3. **Agent executes operations** when you ask it to create a wallet or send a transaction, generating the correct WDK code
4. **You confirm** before any write operation (transactions, swaps, bridges) goes through

The skill includes security guidance: pre-transaction validation checklists, prompt injection detection rules, and mandatory key cleanup patterns.

## Self-Custodial vs Hosted

WDK's agent skills use a self-custodial model where your agent controls its own keys locally. This differs from hosted solutions where a third party manages your keys.

| Feature          | WDK                                                            | Coinbase Agentic Wallet       | Privy Server Wallets          |
| ---------------- | -------------------------------------------------------------- | ----------------------------- | ----------------------------- |
| Custody model    | Self-custodial                                                 | Coinbase-hosted               | Privy-hosted (server)         |
| Multi-chain      | Yes (EVM, Bitcoin, Solana, TON, Tron, Spark + more)            | EVM + Solana                  | EVM + Solana + Bitcoin + more |
| Open source      | Yes (SDK + skills)                                             | CLI/skills open, infra closed | Skills open, API closed       |
| MCP support      | Yes ([MCP Toolkit](https://docs.wdk.tether.io/ai/mcp-toolkit)) | Via skills                    | Via skills                    |
| OpenClaw support | Yes (`npx skills add tetherto/wdk-agent-skills`)               | Yes (npx skills)              | Yes (ClawHub skill)           |
| x402 payments    | Via [community extensions](#community-projects)                | Yes (native)                  | No                            |
| Key management   | Local / self-managed                                           | Coinbase infrastructure       | Privy infrastructure          |

## Use With Agent Platforms

| Platform                     | How to Use                                                                                                                               |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **OpenClaw**                 | Run `npx skills add tetherto/wdk-agent-skills` and select your agent. See [OpenClaw Integration](https://docs.wdk.tether.io/ai/openclaw) |
| **Claude**                   | Upload `SKILL.md` as project knowledge, or paste into conversation                                                                       |
| **Cursor / Windsurf**        | Clone to `.cursor/skills/wdk` or `.windsurf/skills/wdk`                                                                                  |
| **Any MCP-compatible agent** | Use the [MCP Toolkit](https://docs.wdk.tether.io/ai/mcp-toolkit) for structured tool calling                                             |
| **Any other agent**          | Copy `SKILL.md` into system prompt or conversation context                                                                               |

## Community Projects

Projects built by the community using WDK's agentic capabilities:

| Project                                                                                           | Description                                                  |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [wdk-wallet-evm-x402-facilitator](https://github.com/SemanticPay/wdk-wallet-evm-x402-facilitator) | Agent-to-agent payments using the x402 HTTP payment protocol |
| [x402-usdt0](https://github.com/baghdadgherras/x402-usdt0)                                        | Reference implementation of x402 on Plasma with USDT0        |
| [Novanet zkML Guardrails](https://github.com/hshadab/tether)                                      | Zero-knowledge ML safety checks for wallet operations        |

## Resources

* [WDK SKILL.md on GitHub](https://github.com/tetherto/wdk-docs/blob/main/skills/wdk/SKILL.md) - The full skill file agents consume
* [WDK Agent Skills](https://github.com/tetherto/wdk-agent-skills) - Install via `npx skills add tetherto/wdk-agent-skills`
* [AgentSkills Specification](https://agentskills.io/specification) - The skill format standard
* [WDK MCP Toolkit](https://github.com/tetherto/wdk-mcp-toolkit) - MCP server for structured tool calling
* [WDK Core](https://github.com/tetherto/wdk-core) - The core SDK

***

## Need Help?

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-discord">:discord:</i></td><td><strong>Discord Community</strong></td><td>Connect with developers, ask questions, share your projects</td><td><a href="https://discord.gg/arYXDhHB2w" class="button primary">Join Community</a></td><td><a href="https://discord.gg/arYXDhHB2w">https://discord.gg/arYXDhHB2w</a></td></tr><tr><td><i class="fa-github">:github:</i></td><td><strong>GitHub Issues</strong></td><td>Report bugs, request features, and get technical help</td><td><a href="https://github.com/tetherto/wdk-core" class="button secondary">Open an Issue</a></td><td><a href="https://github.com/tetherto/wdk-core">https://github.com/tetherto/wdk-core</a></td></tr><tr><td><i class="fa-envelope">:envelope:</i></td><td><strong>Email Contact</strong></td><td>For sensitive or private matters, contact our team directly</td><td><a href="mailto:wallet-info.tether.io" class="button secondary">Send an email</a></td><td><a href="mailto:wallet-info.tether.io">mailto:wallet-info.tether.io</a></td></tr></tbody></table>
