Give Claude Code deep knowledge of Mesh SDK packages for faster Cardano development

Claude Code Skills provide your AI assistant with comprehensive knowledge of Mesh SDK packages. Once installed, Claude understands the full API, common patterns, and troubleshooting approaches without needing to search documentation.

Overview

Skills are structured knowledge files that Claude Code loads when you mention relevant trigger words. 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	Claude 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()`)	Claude knows the correct order
Looking up CIP standards	Claude understands CIP-30, CIP-8, etc.

Available Skills

Skill	Package	Description
`transaction`	`@meshsdk/transaction`	MeshTxBuilder API, minting, Plutus scripts, governance
`wallet`	`@meshsdk/wallet`	Browser wallets, headless wallets, signing, CIP-30
`core-cst`	`@meshsdk/core-cst`	Serialization, resolvers, Plutus data, low-level utilities

Quick Start

Option 1: Claude Code CLI (Recommended)

Install all skills with a single command:

claude skill add @meshsdk/ai-skills

Or link a specific skill from source:

claude skill link ./transaction

Option 2: Manual Installation

Copy skill folders to Claude Code's skill directory:

cp -r transaction ~/.claude/skills/mesh-transaction
cp -r wallet ~/.claude/skills/mesh-wallet
cp -r core-cst ~/.claude/skills/mesh-core-cst

Option 3: Project-Local (Team-Wide)

Add skills to your repository so everyone on your team gets them automatically:

mkdir -p .claude/skills
cp -r transaction .claude/skills/mesh-transaction
cp -r wallet .claude/skills/mesh-wallet
cp -r core-cst .claude/skills/mesh-core-cst

Commit 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 transaction/SKILL.md .cursorrules

For multiple skills:

cat transaction/SKILL.md wallet/SKILL.md > .cursorrules

How Skills Work

Each skill defines triggers in its frontmatter. When you mention trigger words like "mesh", "cardano transaction", or "browser wallet", Claude loads the relevant context.

Example skill frontmatter:

---
name: mesh-transaction
triggers:
  - mesh
  - cardano transaction
  - meshtxbuilder
  - mint nft
  - plutus script
---

When you say "help me build a transaction with MeshTxBuilder", Claude automatically loads the transaction skill and has full context about the API.

Usage Examples

Once installed, ask Claude:

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-30

Work with Plutus:

Show me how to interact with a Plutus script

Debug errors:

Why am I getting 'missing required signer' error?

Complete Example

Here is an example conversation after installing skills:

You: Create a transaction that mints an NFT with metadata

Claude: (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);

Notice how Claude provides complete, working code with proper imports and the correct method order.

Skill Structure

Each skill contains:

skill-name/
  SKILL.md      # Main skill file with API reference and patterns
  examples/     # Optional: Additional code examples
  errors/       # Optional: Error-specific troubleshooting

The SKILL.md file follows a standardized format:

---
name: skill-name
triggers:
  - trigger1
  - trigger2
---

# API Reference
[Complete method documentation]

# Common Patterns
[Working code recipes]

# Troubleshooting
[Solutions to common errors]

Troubleshooting

Skills not loading

Verify the skill is installed: claude skill list
Check trigger words match your query
Restart Claude Code after installation

Outdated information

Update skills: claude skill update @meshsdk/ai-skills
Check for new versions on npm

Skills conflict with each other

Skills are designed to work together
If you see conflicts, file an issue on GitHub

Cursor not recognizing .cursorrules

Ensure the file is in the project root
Restart Cursor after creating the file
Check file is not empty

Source Code

The skills are open source. Contribute or report issues at:

github.com/MeshJS/Mesh-AI/tree/main/claude-skills

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
Claude Code Documentation - Learn more about Claude Code

Claude Code Skills

On this page