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 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-code
npx skills add aptos-labs/aptos-agent-skills -a cursor
npx skills add aptos-labs/aptos-agent-skills -a copilot

See the upstream INSTALL.md for selective skill installs.

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

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

git clone https://github.com/aptos-labs/aptos-agent-skills.git
cp -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

Move Skills

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

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

TypeScript SDK Skills

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

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

Project Skills

Skill	Description
create-aptos-project	Scaffold a new Aptos dApp with create-aptos-dapp

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

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

Skill	Author	Description
smoothsend-gasless	ivedmohan	Sponsor gas fees for Aptos transactions with SmoothSend

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

See CONTRIBUTING.md for details.