Mesh SDK AI Skills

AI assistant skills for building on Cardano with Mesh SDK.

What is this?

These are Agent Skills that help AI coding assistants (Claude Code, Cursor, GitHub Copilot, Codex, and 37+ others) understand and work with Mesh SDK packages. When installed, your AI assistant gains deep knowledge of:

• Transaction building - MeshTxBuilder API, patterns, troubleshooting
• Wallet integration - Browser wallets, signing, CIP standards
• Low-level utilities - Serialization, resolvers, Plutus data, CIP-8

Why Use This?

Building on Cardano with Mesh SDK has a steep learning curve. These skills eliminate that friction:

Challenge Without Skills	With Skills Installed
Must read extensive docs to understand API	AI assistant 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.

In practice, instead of:

1. Opening Mesh docs
2. Searching for the right method
3. Finding an example
4. Adapting it to your code

You just ask: "Help me connect a browser wallet and send 10 ADA to this address" — and get working, contextual code.

Available Skills

Skill	Package	Description
mesh-transaction	@meshsdk/transaction	Transaction building with MeshTxBuilder
mesh-wallet	@meshsdk/wallet	Browser & headless wallet integration
mesh-core-cst	@meshsdk/core-cst	Low-level serialization & utilities

Installation

Option 1: skills.sh CLI (Recommended)

Install all Mesh skills into any supported agent with a single command:

# Install all 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 codex

Browse on skills.sh to discover more agent skills.

Option 2: Claude Code - Manual

Copy skill folders to Claude Code's skill directory:

# Copy all 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-cst

Option 3: Project-Local (Team-Wide)

Add to your repository so everyone on the team gets the skills 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-cst

Then commit to git — any team member using Claude Code gets the skills when they clone the repo.

Option 4: Cursor IDE

Copy the skill's main file as Cursor rules:

cp mesh-transaction/SKILL.md .cursorrules

For multiple skills, concatenate them:

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

How It Works

Each skill has a SKILL.md with a description field that tells the AI when to activate:

---
name: mesh-transaction
description: Use when building Cardano transactions with MeshJS SDK...
---

When the description matches your request, the AI loads the full skill context including:

• Full API reference - Every method, parameter, and return type
• Common patterns - Working code recipes for typical tasks
• Troubleshooting - Solutions to common errors

Skill Structure

Each skill contains:

File	Purpose
SKILL.md	Main entry - description, overview, quick reference
*.md	Domain-specific documentation
PATTERNS.md	Common recipes with working code
TROUBLESHOOTING.md	Error solutions and debugging

Usage Examples

Once installed, ask your AI assistant:

• "Build a transaction that sends 5 ADA"
• "How do I mint an NFT with Mesh?"
• "Help me connect a browser wallet"
• "Show me how to interact with a Plutus script"
• "Why am I getting 'missing required signer' error?"
• "What's the correct order for spending from a script?"

Contributing

We welcome contributions to improve and expand Mesh SDK skills.

How to Contribute

1. Fork the skills repository
2. Create a branch for your changes
3. Edit or add skill files
4. Submit a PR with a clear description of your changes

Adding a New Skill

mkdir my-new-skill

Each new skill needs at minimum a SKILL.md with frontmatter:

---
name: my-new-skill
description: Use when [describe what this skill helps with and when to activate it].
license: Apache-2.0
metadata:
  author: YourName
  version: "1.0"
---

Then add supporting files:

• SKILL.md - Overview, quick reference, constructor options
• {DOMAIN}.md - Complete API reference
• PATTERNS.md - Common recipes with working code examples
• TROUBLESHOOTING.md - Error messages, causes, and solutions

See the Agent Skills Specification for the full format reference.

Improving Existing Skills

• Fix inaccurate code examples or API signatures
• Add missing methods or parameters to API docs
• Add new patterns for common use cases
• Add troubleshooting entries for errors you've encountered

Related

• Mesh SDK Documentation
• Mesh GitHub
• Agent Skills Specification
• skills.sh Directory

License

Apache-2.0