Aptos Agent Skills

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 Browse the source code, skill definitions, and contribution guidelines

Installation

Using the Skills CLI (recommended)

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

This installs the skills into your project so your AI coding assistant can use them automatically.

Claude Code Plugin

claude plugin add aptos-labs/aptos-agent-skills

Manual Installation

Clone the repository and copy the skills into your project's .claude/skills/aptos/ directory:

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

Available Skills

Move Skills

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

| Skill | Description | | ---------------------------- | --------------------------------------------------------------------- | | write-contracts | Write Move smart contracts following Aptos best practices | | generate-tests | Generate comprehensive unit and integration tests for Move modules | | security-audit | Audit Move contracts for common vulnerabilities and security issues | | deploy-contracts | Deploy Move modules to Aptos devnet, testnet, or mainnet | | search-aptos-examples | Search official Aptos example contracts for reference implementations | | analyze-gas-optimization | Analyze and optimize Move code for gas efficiency | | modernize-move | Upgrade Move code to use the latest Aptos Move features |

TypeScript SDK Skills

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

| Skill | Description | | ------------------------- | ----------------------------------------------------------- | | use-ts-sdk | General guidance for using the Aptos TypeScript SDK | | ts-sdk-client | Configure and use the Aptos client for network interactions | | ts-sdk-account | Create and manage Aptos accounts and key pairs | | ts-sdk-address | Work with Aptos addresses and address formats | | ts-sdk-transactions | Build, simulate, sign, and submit transactions | | ts-sdk-view-and-query | Query on-chain data and call view functions | | ts-sdk-types | Use TypeScript types from the SDK correctly | | ts-sdk-wallet-adapter | Integrate wallet connections in frontend applications |

Project Skills

| Skill | Description | | ------------------------ | ------------------------------------------------------------------------------ | | create-aptos-project | Scaffold a new Aptos project with Move contracts, TypeScript SDK, and frontend |

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 ts-sdk-wallet-adapter and other SDK skills to build the UI

Community Skills

The repository includes a community-skills/ directory where anyone can contribute additional skills. To add your own:

1. Create a new skill file following the existing format
2. Submit a pull request to the aptos-agent-skills repository

See the CONTRIBUTING.md for details on the contribution process.