jiayaoqijia aptos-official-agent-skills
Source: github.com/aptos-labs/aptos-agent-skills. The body below is the upstream README.md captured at the time of registration.
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
- Create —
/create-aptos-projectscaffolds withnpx create-aptos-dapp - Write —
/write-contractsgenerates Move modules - Test —
/generate-testscreates test suites with 100% coverage - Audit —
/security-auditchecks for vulnerabilities - Deploy —
/deploy-contractspublishes to your target network - Frontend —
/use-ts-sdkwires 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.