Aptos Agent Skills

AI-assisted Aptos blockchain development with Claude Code, Cursor, and GitHub Copilot. These skills give your AI coding assistant deep knowledge of Move smart contract development, the Aptos TypeScript SDK, and the full dApp lifecycle — from project scaffolding to deployment.

• Move V2 Object Model — Write secure smart contracts using modern Aptos patterns
• Gas Optimization — Analyze and reduce transaction costs in Move contracts
• Security Auditing — Catch vulnerabilities before deploying to devnet, testnet, or mainnet
• TypeScript SDK — Integrate Aptos wallets, transactions, and view functions into your frontend
• AI-Powered Workflow — Skills activate automatically based on developer intent

Install

Recommended

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

Claude Code plugin

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

Manual

git clone https://github.com/aptos-labs/aptos-agent-skills.git

See INSTALL.md for selective installation and other options.

Aptos Development Skills

Move Smart Contracts

Skill	Purpose
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 contracts to 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 V2 object model

TypeScript SDK

Skill	Purpose
use-ts-sdk	Aptos TypeScript SDK orchestrator for frontend integration
ts-sdk-client	Set up 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 Aptos 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 Setup

Skill	Purpose
create-aptos-project	Scaffold new Aptos dApp projects with create-aptos-dapp

Community Skills

Community-contributed skills built by developers across the Aptos ecosystem. These are independently maintained and have not been reviewed by Aptos Labs. See community-skills/ for contribution guidelines.

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

Quick Start

Claude Code

Skills activate automatically based on what you say:

"Create a new dApp"           → project scaffolding
"Write an NFT contract"       → /write-contracts
"Write tests for this"        → /generate-tests
"Check security"              → /security-audit
"Deploy to testnet"           → /deploy-contracts
"Add a frontend"              → /use-ts-sdk

Cursor / Copilot

Reference skill files directly in prompts:

@skills/move/write-contracts/SKILL.md Help me build an NFT marketplace

Include CLAUDE.md in your workspace context for full skill routing and auto-recommendations.

Aptos dApp Development Workflow

1. Create — /create-aptos-project scaffolds with npx create-aptos-dapp
2. Write — /write-contracts generates Move modules
3. Test — /generate-tests creates test suites with 100% coverage
4. Audit — /security-audit checks for vulnerabilities
5. Deploy — /deploy-contracts publishes to your target network
6. Frontend — /use-ts-sdk wires up TypeScript integration

See CLAUDE.md for all workflows, global rules, and pattern references.

Learn More

Resource	Description
CLAUDE.md	Full guide for AI assistants — workflows, rules, skill routing
INSTALL.md	Installation options and selective skill setup
patterns/	Reference docs for objects, digital assets, fungible assets, security, and more
community-skills/	Community-contributed skills and contribution guidelines
aptos.dev	Official Aptos documentation
SkillsMP	Browse Aptos skills on SkillsMP
Skills.sh	Browse and install via Skills.sh

Contributing

We welcome contributions — new skills, pattern improvements, examples, and bug fixes. See CONTRIBUTING.md for guidelines.

License

MIT — see LICENSE for details.