Algorand Agent Skills

April 16, 2026 · View on GitHub

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.

Quick Start

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 (Recommended)

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

Claude Code

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

Cursor

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

GitHub Copilot

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

What's Included

Skills

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:

Skill	Description
`algorand-project-setup`	AlgoKit project initialization, CLI commands, finding examples
`algorand-typescript`	Full TypeScript lifecycle — PuyaTs syntax, testing, deployment, utils, ARC standards, errors
`algorand-python`	Full Python lifecycle — PuyaPy syntax, testing, deployment, utils, ARC standards, errors
`algorand-frontend`	React dApp frontends with wallet integration
`algokit-utils-py`	AlgoKit Utils Python — client setup, payments, assets, contract deployment & interaction
`algokit-utils-ts`	AlgoKit Utils TypeScript — client setup, payments, assets, contract deployment & interaction

x402 Skills (contributed by GoPlausible):

Skill	Description
`algorand-x402-typescript`	TypeScript x402 HTTP-native payments — clients, servers, facilitators, paywalls, Next.js
`algorand-x402-python`	Python x402 HTTP-native payments — clients, servers, facilitators, Bazaar

MCP Servers

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)

Configuration Files

Tool	Files
OpenCode	`opencode.json`
Claude Code	`.mcp.json`, `CLAUDE.md`
Cursor	`.cursor/mcp.json`, `.cursor/skills/`
Copilot	`.github/copilot-instructions.md`

AGENTS.md

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

GitHub PAT Setup

All MCP configurations require a GitHub Personal Access Token:

Go to https://github.com/settings/personal-access-tokens
Create a new token with an expiration date (required)
Default permissions are sufficient (public repo read access)
Set the GITHUB_TOKEN environment variable:
```
export GITHUB_TOKEN="github_pat_..."
```
Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist it.

Packaged Skills (Releases)

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.

Resources

Contributing

See CONTRIBUTING.md for guidelines on:

Adding new skills
Improving existing skills
Skill format and best practices

License

MIT License - see LICENSE