[Aptos Agent Skills](https://github.com/aptos-labs/aptos-agent-skills) is a collection of pre-built AI skills that give coding assistants like Claude Code, Cursor, and GitHub Copilot deep expertise in Aptos development. The skills cover Move smart contracts, the TypeScript SDK, and full-stack dApp scaffolding.

[Aptos Agent Skills on GitHub](https://github.com/aptos-labs/aptos-agent-skills) Browse the source code, skill definitions, and contribution guidelines

## Installation

[](#installation)

### Using the Skills CLI (recommended)

[](#using-the-skills-cli-recommended)

```
npx skills add aptos-labs/aptos-agent-skills
```

This installs the skills so your AI coding assistant can use them automatically. Target a specific agent with `-a`:

```
npx skills add aptos-labs/aptos-agent-skills -a claude-codenpx skills add aptos-labs/aptos-agent-skills -a cursornpx skills add aptos-labs/aptos-agent-skills -a copilot
```

See the upstream [INSTALL.md](https://github.com/aptos-labs/aptos-agent-skills/blob/main/INSTALL.md) for selective skill installs.

### Claude Code plugin

[](#claude-code-plugin)

Inside a Claude Code session, add the repository as a plugin marketplace:

```
/plugin marketplace add aptos-labs/aptos-agent-skills
```

### Manual installation

[](#manual-installation)

Clone the repository and copy the skills into your agent’s skills directory:

```
git clone https://github.com/aptos-labs/aptos-agent-skills.gitcp -r aptos-agent-skills/skills/* ~/.claude/skills/cp -r aptos-agent-skills/patterns/* ~/.claude/patterns/
```

Include `CLAUDE.md` from the cloned repository in your workspace context so the assistant can route to the right skill.

## Available Skills

[](#available-skills)

### Move Skills

[](#move-skills)

These skills help AI assistants write, test, audit, and deploy Move smart contracts:

<table><thead><tr><th>Skill</th><th>Description</th></tr></thead><tbody><tr><td><strong>write-contracts</strong></td><td>Generate secure Aptos Move V2 smart contracts</td></tr><tr><td><strong>generate-tests</strong></td><td>Generate Move unit tests targeting 100% code coverage</td></tr><tr><td><strong>security-audit</strong></td><td>Security audit for Move smart contracts before deployment</td></tr><tr><td><strong>deploy-contracts</strong></td><td>Deploy Move modules to Aptos devnet, testnet, or mainnet</td></tr><tr><td><strong>search-aptos-examples</strong></td><td>Search aptos-core for reference implementations and patterns</td></tr><tr><td><strong>analyze-gas-optimization</strong></td><td>Analyze and reduce gas costs in Move smart contracts</td></tr><tr><td><strong>modernize-move</strong></td><td>Migrate Move V1 resource accounts to the V2 object model</td></tr></tbody></table>

### TypeScript SDK Skills

[](#typescript-sdk-skills)

These skills help AI assistants use the Aptos TypeScript SDK correctly:

<table><thead><tr><th>Skill</th><th>Description</th></tr></thead><tbody><tr><td><strong>use-ts-sdk</strong></td><td>Aptos TypeScript SDK orchestrator for frontend integration</td></tr><tr><td><strong>ts-sdk-client</strong></td><td>Set up the Aptos client with AptosConfig and network selection</td></tr><tr><td><strong>ts-sdk-account</strong></td><td>Create Aptos accounts and signers from private keys or derivation paths</td></tr><tr><td><strong>ts-sdk-address</strong></td><td>Parse and derive Aptos account addresses (AIP-40)</td></tr><tr><td><strong>ts-sdk-transactions</strong></td><td>Build, sign, and submit transactions, including sponsored and multi-agent</td></tr><tr><td><strong>ts-sdk-view-and-query</strong></td><td>Call Move view functions and query on-chain Aptos data</td></tr><tr><td><strong>ts-sdk-types</strong></td><td>Map Move types to TypeScript (<code dir="auto">u64</code>, <code dir="auto">u128</code>, <code dir="auto">address</code>, <code dir="auto">vector</code>)</td></tr><tr><td><strong>ts-sdk-wallet-adapter</strong></td><td>Integrate Aptos wallets into React apps with <code dir="auto">useWallet</code></td></tr></tbody></table>

### Project Skills

[](#project-skills)

<table><thead><tr><th>Skill</th><th>Description</th></tr></thead><tbody><tr><td><strong>create-aptos-project</strong></td><td>Scaffold a new Aptos dApp with <code dir="auto">create-aptos-dapp</code></td></tr></tbody></table>

## Recommended Workflow

[](#recommended-workflow)

For a typical Aptos dApp, use the skills in this order:

1.  **Scaffold** — Use `create-aptos-project` to set up the project structure
2.  **Write** — Use `write-contracts` to create your Move smart contracts
3.  **Test** — Use `generate-tests` to create comprehensive test coverage
4.  **Audit** — Use `security-audit` to check for vulnerabilities
5.  **Deploy** — Use `deploy-contracts` to publish to devnet or testnet
6.  **Frontend** — Use `use-ts-sdk` and the other TypeScript SDK skills to build the UI

## Community Skills

[](#community-skills)

The repository includes a `community-skills/` directory. Community skills are independently maintained and have not been reviewed by Aptos Labs.

<table><thead><tr><th>Skill</th><th>Author</th><th>Description</th></tr></thead><tbody><tr><td><strong>smoothsend-gasless</strong></td><td>ivedmohan</td><td>Sponsor gas fees for Aptos transactions with SmoothSend</td></tr></tbody></table>

To add your own:

1.  Create a new skill following the existing format under `community-skills/`
2.  Submit a pull request to the [aptos-agent-skills repository](https://github.com/aptos-labs/aptos-agent-skills)

See [CONTRIBUTING.md](https://github.com/aptos-labs/aptos-agent-skills/blob/main/CONTRIBUTING.md) for details.