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.