Agent Skills for AI Coding Assistants
Give your AI coding assistant deep knowledge of Mesh SDK for faster Cardano development - works with Claude Code, Cursor, Codex, and 37+ tools
Agent Skills provide your AI coding assistant with comprehensive knowledge of Mesh SDK packages. Once installed, your assistant understands the full API, common patterns, and troubleshooting approaches without needing to search documentation.
Compatible with Claude Code, Cursor, GitHub Copilot, Codex, and 37+ other tools.
Overview
Skills are structured knowledge files that AI assistants load based on context. Each skill contains:
- Complete API reference with every method, parameter, and return type
- Working code recipes for common tasks
- Troubleshooting guides for frequent errors
- Best practices and gotchas
Use Cases
| Challenge Without Skills | With Skills Installed |
|---|---|
| Must read docs to understand API | AI already knows the full API |
| Trial-and-error for transaction patterns | Ask "build a transaction that sends 5 ADA" and get working code |
| Debugging cryptic Cardano errors | Troubleshooting guides built into AI context |
Forgetting method order (e.g., spendingPlutusScriptV2() before txIn()) | AI knows the correct order |
| Looking up CIP standards | AI understands CIP-30, CIP-8, etc. |
Available Skills
| Skill | Package | Description |
|---|---|---|
mesh-transaction | @meshsdk/transaction | MeshTxBuilder API, minting NFTs, Plutus scripts, governance, DRep registration |
mesh-wallet | @meshsdk/wallet | Browser wallets (Eternl, Nami, Lace, Flint, Yoroi), headless wallets, signing, CIP-30 |
mesh-core-cst | @meshsdk/core-cst | CBOR serialization, Plutus data, address resolution, CIP-8, native script hashing |
Quick Start
Option 1: skills.sh CLI (Recommended)
Install all skills with a single command:
# Install all Mesh skills
npx skills add MeshJS/skills
# Install a specific skill
npx skills add MeshJS/skills --skill mesh-transaction
# Install for a specific agent
npx skills add MeshJS/skills -a claude-code
npx skills add MeshJS/skills -a cursor
npx skills add MeshJS/skills -a codexBrowse available skills on skills.sh.
Option 2: Manual Installation (Claude Code)
Copy skill folders to Claude Code's skill directory:
cp -r mesh-transaction ~/.claude/skills/mesh-transaction
cp -r mesh-wallet ~/.claude/skills/mesh-wallet
cp -r mesh-core-cst ~/.claude/skills/mesh-core-cstOption 3: Project-Local (Team-Wide)
Add skills to your repository so everyone on your team gets them automatically:
mkdir -p .claude/skills
cp -r mesh-transaction .claude/skills/mesh-transaction
cp -r mesh-wallet .claude/skills/mesh-wallet
cp -r mesh-core-cst .claude/skills/mesh-core-cstCommit to git. Any team member using Claude Code will have the skills when they clone the repo.
Option 4: Cursor IDE
For a single skill:
cp mesh-transaction/SKILL.md .cursorrulesFor multiple skills:
cat mesh-transaction/SKILL.md mesh-wallet/SKILL.md > .cursorrulesHow Skills Work
Each skill has a SKILL.md file with a description field that tells the AI assistant when to activate:
---
name: mesh-transaction
description: Use when building Cardano transactions with MeshJS SDK. Covers MeshTxBuilder API for sending ADA, minting NFTs and tokens, spending from Plutus scripts, staking, governance voting, DRep registration, and multi-sig patterns.
license: Apache-2.0
metadata:
author: MeshJS
version: "1.0"
---When you ask something like "help me build a transaction with MeshTxBuilder", your AI assistant matches the description and loads the full skill context including API reference, patterns, and troubleshooting.
Usage Examples
Once installed, ask your AI assistant:
Build transactions:
Build a transaction that sends 5 ADA to addr1qy...Mint NFTs:
How do I mint an NFT with a Plutus minting policy?Connect wallets:
Help me connect a browser wallet using CIP-30Work with Plutus:
Show me how to interact with a Plutus V3 scriptDebug errors:
Why am I getting 'missing required signer' error?Governance:
How do I register as a DRep and vote on a proposal?Complete Example
Here is an example conversation after installing skills:
You: Create a transaction that mints an NFT with metadata
AI Assistant: (with skills loaded)
import { MeshTxBuilder, ForgeScript, Mint, AssetMetadata } from "@meshsdk/transaction";
import { MeshCardanoBrowserWallet } from "@meshsdk/wallet";
// Connect wallet
const wallet = await MeshCardanoBrowserWallet.enable("eternl");
const address = await wallet.getChangeAddressBech32();
const utxos = await wallet.getUtxosMesh();
// Create forge script from address
const forgeScript = ForgeScript.fromAddress(address);
const policyId = forgeScript.policyId;
// Define metadata
const metadata: AssetMetadata = {
name: "My NFT",
image: "ipfs://...",
description: "My first NFT with Mesh",
};
// Build mint transaction
const txBuilder = new MeshTxBuilder();
const mint: Mint = {
assetName: "MyNFT",
assetQuantity: "1",
metadata: metadata,
recipient: address,
};
const unsignedTx = await txBuilder
.mint("1", policyId, mint.assetName)
.mintingScript(forgeScript)
.metadataValue("721", { [policyId]: { [mint.assetName]: metadata } })
.selectUtxosFrom(utxos)
.changeAddress(address)
.complete();
// Sign and submit
const signedTx = await wallet.signTx(unsignedTx, false);
const txHash = await wallet.submitTx(signedTx);
console.log("Transaction submitted:", txHash);Skill Structure
Each skill follows the Agent Skills specification:
mesh-transaction/
SKILL.md # Main entry - description, overview, quick reference
TRANSACTION.md # Complete API reference
PATTERNS.md # Common recipes with working code
TROUBLESHOOTING.md # Error solutions and debuggingThe SKILL.md file uses YAML frontmatter with name (must match directory name) and description (tells the AI when to activate).
Contributing
We welcome contributions to improve and expand Mesh SDK skills.
- Fork the skills repository
- Create a branch for your changes
- Edit or add skill files - fix code examples, add missing methods, add troubleshooting entries
- Submit a PR with a clear description of your changes
See the Agent Skills Specification for the full format reference.
Source Code
The skills are open source and hosted at:
github.com/MeshJS/skillsRelated Resources
- MCP Server - Real-time AI integration for VS Code, Cursor, and Claude Desktop
- llms.txt - AI-friendly documentation for any tool
- MeshAI Chatbot - Browser-based AI assistant
- skills.sh - Browse and discover agent skills
- agentskills.io - Agent Skills specification