Agent skills and configurations for AI-assisted Algorand development. Give your AI coding assistant the knowledge to build smart contracts, deploy applications, and follow Algorand best practices.

Choose your AI coding tool and follow the setup guide.

Note: These instructions are for per-project setup. For global/user-level configuration, refer to each tool's official documentation.

OpenCode is an open-source AI coding agent with full MCP support.

# 1. Clone this repo
git clone https://github.com/algorand-devrel/algorand-agent-skills.git

# 2. In your AlgoKit project, copy the files:
cp -r algorand-agent-skills/skills ./
cp algorand-agent-skills/setups/AGENTS.md ./
cp algorand-agent-skills/setups/opencode/opencode.json ./

# 3. Set GITHUB_TOKEN env var (see GitHub PAT Setup below)
# 4. Run: opencode

Full OpenCode setup guide

cp -r algorand-agent-skills/skills ./
cp algorand-agent-skills/setups/AGENTS.md ./
cp algorand-agent-skills/setups/claude-code/.mcp.json ./
cp algorand-agent-skills/setups/claude-code/CLAUDE.md ./

Full Claude Code setup guide

cp algorand-agent-skills/setups/AGENTS.md ./
mkdir -p .cursor/skills
cp -r algorand-agent-skills/skills/* .cursor/skills/
cp algorand-agent-skills/setups/cursor/mcp.json .cursor/mcp.json

Full Cursor setup guide

cp -r algorand-agent-skills/skills ./
cp algorand-agent-skills/setups/AGENTS.md ./
mkdir -p .github
cp algorand-agent-skills/setups/copilot/copilot-instructions.md ./.github/

Full Copilot setup guide

Skills teach AI assistants how to complete Algorand-specific tasks. Each skill has a SKILL.md router that uses progressive disclosure — the agent loads only the specific reference files it needs.

Core Skills:

x402 Skills (contributed by GoPlausible):

MCP (Model Context Protocol) servers give AI assistants access to external tools:

Kapa MCP - Algorand Documentation

• Semantic search over official Algorand docs
• URL: https://algorand-docs.mcp.kapa.ai/
• Auth: OAuth (prompted on first use)

GitHub MCP - Code Examples

• Access canonical examples from Algorand repositories
• URL: https://api.githubcopilot.com/mcp/
• Auth: GitHub PAT (requires expiration date)

The setups/AGENTS.md file is the canonical instruction set for AI assistants working on Algorand projects. Copy it to your project root (or merge with your existing AGENTS.md).

It includes:

• When and how to use each skill
• MCP tool reference
• Development workflows
• Troubleshooting guidance

All MCP configurations require a GitHub Personal Access Token:

1. Go to https://github.com/settings/personal-access-tokens
2. Create a new token with an expiration date (required)
3. Default permissions are sufficient (public repo read access)
4. Set the GITHUB_TOKEN environment variable:

   export GITHUB_TOKEN="github_pat_..."

   Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist it.

Pre-packaged .zip files are available from GitHub Releases. These are single-file bundles that can be extracted directly into your project's skills directory.

To package skills locally:

./scripts/package-all-skills.sh

Packaged skills will be output to the dist/ directory.

• AlgoKit CLI
• Algorand Developer Portal
• Puya TypeScript (PuyaTs)
• Puya Python (PuyaPy)
• x402 Protocol on Algorand
• OpenCode
• Claude Code

See CONTRIBUTING.md for guidelines on:

• Adding new skills
• Improving existing skills
• Skill format and best practices

MIT License - see LICENSE