convez.ai
SkillDesenvolvimento WebAvançado
solanabr

Solana AI Kit

solanabr/solana-ai-kit

Configuração multi-agente Claude para builders Solana full-stack

Ver no GitHub
BomPluginScore · de 0 a 100

Kit completo de configuração Claude otimizado para desenvolvimento full-stack em Solana. Integra 15 agentes especializados, 29 comandos de workflow, 7 servidores MCP e carregamento progressivo de skills para construir aplicações blockchain de forma eficiente e token-conscious.

Instalação

$npx convez-ai solanabr/solana-ai-kit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
112
Forks
59
Acompanhando
2
Saúde
50%
Último commit
há 3 dias
Versão
v2.1.0
Issues abertas
19
Contribuidores
3

Casos de uso

  • Desenvolvimento de smart contracts com Anchor e Pinocchio
  • Construção de aplicações DeFi e tokens na Solana
  • Integração de frontend, mobile e backend em monorepos
  • DevOps, testes, deploy e profiling automatizados
  • Pesquisa e documentação de projetos blockchain

Veredito

Recurso maduro e bem estruturado para builders Solana experientes que usam Claude Code/Codex. Excelente arquitetura de agentes e carregamento dinâmico de skills economiza tokens e contexto. Recomendado para equipes que já conhecem Solana e querem acelerar o workflow de desenvolvimento.

README

A tradução para o português deste README ainda está na fila.

Solana AI Kit

CI Version License Solana Claude Code

Production-ready Claude Code configuration for full-stack Solana development. Combines best practices from multiple sources into an agent-optimized, token-efficient config you can install and adapt to your specific project.

The idea here is to provide a generic CLAUDE.md that relies on subagents to plan and execute actions, dynamically loading markdown files, saving tokens and context in the end of the day. This config fully leverages the official Claude Code config recommendations:

  • Rules are only loaded whenever specific file types are involved;
  • SKILL.md is a mega hub to dynamically-disclosed skill files that are directly fetched from the best skill repos distributed across the ecosystem (Solana Foundation, Colosseum, Solana Mobile, SendAI, etc);
  • Plus, its CLAUDE-solana.md is than half the size of the usual CLAUDE.md, leaving space for its self improvements programmed into the agents, noting and learning from anti-patterns, errors, recurrency and more. For less important notes, CLAUDE.local.md is constantly maintained by agents as well and, on monorepos, per-folder CLAUDE.md is also maintained.

Current multi-agent workflow favors monorepos, so we use a single CLAUDE.md/config for the whole project while leveraging agents and context-specific skills to solve each step of builder flow.

If you installed manually, remember to rename ./CLAUDE-solana.md back to ./CLAUDE.md, as the current top-level CLAUDE.md file is focused on maintaining the repo itself.

What This Is

A complete .claude/ configuration that turns Claude into a Solana development expert with:

  • 15 specialized agents for different tasks (architecture, Anchor, Pinocchio, DeFi, tokens, frontend, mobile, backend, DevOps, QA, docs, games, Unity, learning, research)
  • 29 workflow commands for building, testing, deploying, profiling, migrating, and committing
  • 7 MCP server integrations for on-chain data (Helius), Solana docs (solana-dev), library docs (Context7), browser automation (Playwright), context optimization (context-mode), persistent memory (memsearch), and local-validator / mainnet-fork control (Surfpool)
  • Agent teams for multi-step workflows (architect → engineer → QA)
  • Progressive skill loading that only loads context when needed (saves tokens)
  • Auto-loading rules that enforce best practices based on file patterns

Quick Start

# Option 0: Fork Template (Github UI)
claude -m "/cleanup"  # then start claude code running /cleanup so top-level directory of your project isn't polluted


# Option 1: One-liner installer (Claude Code)
curl -fsSL https://aikit.superteam.codes | bash
# Fallback (or before the aikit.superteam.codes DNS is live): curl -fsSL https://raw.githubusercontent.com/solanabr/solana-ai-kit/main/install.sh | bash

# Option 2: One-liner installer (Codex, Opencode, everything else)
curl -fsSL https://aikit.superteam.codes | bash -s -- --agents
# Fallback (or before the aikit.superteam.codes DNS is live): curl -fsSL https://raw.githubusercontent.com/solanabr/solana-ai-kit/main/install.sh | bash -s -- --agents

# Option 3: Manual setup
git clone --recurse-submodules https://github.com/solanabr/solana-ai-kit.git
cp -r solana-ai-kit/.claude /path/to/your-project/
cp solana-ai-kit/CLAUDE-solana.md /path/to/your-project/CLAUDE.md
cd /path/to/your-project && git submodule update --init --recursive

# Option 4: Claude Code plugin (run inside Claude Code)
/plugin marketplace add solanabr/solana-ai-kit
/plugin install solana-ai-kit@stbr
# Commands then namespace as /solana-ai-kit:<name>. The plugin is the CORE kit
# (agents/commands/local skills/MCP/hooks); the curl one-liner (Option 1) is the
# FULL install, adding rules + permissions/sandbox + the 18 ext/ submodules.
# Details: see "Install as a Claude Code plugin" below.

# Start Claude Code
claude

--agents Flag

Pass --agents to install everything into .agents/ instead of .claude/. Same content, different directory name. Useful when .claude/ is already taken or for non-Claude AI tools (Cursor, Windsurf, Copilot, etc.).

bash install.sh --agents /path/to/your-project

To update an --agents install:

# Run from your project root:
bash .agents/bin/update.sh

MCP Setup (Optional)

After installation, configure MCP servers for enhanced capabilities:

# In your project with Claude Code running:
/setup-mcp

This guides you through API key configuration for Helius, Context7, and other MCP servers.

Install as a Claude Code plugin

solana-ai-kit is also its own Claude Code marketplace serving one core plugin. From inside Claude Code:

/plugin marketplace add solanabr/solana-ai-kit
/plugin install solana-ai-kit@stbr

The plugin ships the core kit: the 15 agents, 29 commands, the local go-to-market + registry skills (idea-sprint, pitch-deck, hackathon), the 7 MCP servers, and the dev hooks (banner, formatter, pre-deploy/commit gates). Commands and skills are namespaced — /deploy becomes /solana-ai-kit:deploy.

What the plugin cannot carry (Claude Code plugins are plain git clones — they can't init submodules or ship a permissions/sandbox policy), so these stay exclusive to the full install (install.sh):

  • the lazy-loaded .claude/rules/* code-style law (Rust, Anchor, Pinocchio, TypeScript, .NET)
  • the curated permissions allowlist + sandbox policy
  • the 18 ext/ skill submodules (protocol, security, infra, ecosystem depth)

For protocol-skill depth in plugin form, add the upstream marketplaces instead (routing, not copying) — e.g. /plugin marketplace add sendaifun/skills, ghostsecurity/skills, trailofbits/skills, cloudflare/skills. The plugin's skill hub and skill-registry.json list the current targets.

The two paths are complementary: individuals wanting Solana agents/commands across all their projects → plugin at user scope; project teams working in one repo → install.sh (full kit). If you enable both in the same project, /doctor warns about duplicate commands/hooks/MCP and advises picking one. Plugin auto-update is off by default for third-party marketplaces — refresh with /plugin marketplace update + claude plugin update.

External Skill Submodules

SubmoduleSourcePurpose
ext/solana-devsolana-foundation/solana-dev-skillCore Solana development (programs, frontend, testing, security)
ext/sendaisendaifun/skillsDeFi protocol integrations (Jupiter, Raydium, Kamino, perps, cross-chain, oracles, etc.)
ext/solana-gamesolanabr/solana-game-skillGame development (Unity, PlaySolana, PSG1)
ext/cloudflarecloudflare/skillsInfrastructure (Workers, Agents SDK, MCP servers)
ext/trailofbitstrailofbits/skillsSecurity auditing and vulnerability scanning
ext/qedgenQEDGen/solana-skillsFormal verification with Lean 4 theorem proving
ext/solana-mobilesolana-mobile/solana-mobile-dev-skillMobile Wallet Adapter, Genesis Token, SKR address resolution
ext/colosseumColosseumOrg/colosseum-copilotStartup research, idea validation, hackathon projects
ext/safe-solana-builderfrankcastleauditor/safe-solana-builderSecurity-first code generation (70+ audit-derived rules)
ext/vercelvercel-labs/agent-skillsVercel deployment, Next.js, AI SDK, v0, edge functions
ext/solana-newsendaifun/solana-new32 idea→launch journey skills + idea datasets/knowledge base; routed via local wrappers
ext/ghostsecurityghostsecurity/skills7 AppSec skills: SAST criteria, SCA, secrets, validation
ext/defending-codeanthropics/defending-code-reference-harnessAnthropic vuln-discovery reference harness + 6 skills
ext/jupiterjup-ag/agent-skillsOfficial Jupiter skills: Ultra swap, Lend, swap migration, VRFD
ext/metaplexmetaplex-foundation/skillOfficial Metaplex: Core, Token Metadata, Bubblegum, Candy Machine, Genesis
ext/heliushelius-labs/core-aiOfficial Helius infra skill + unique SVM internals skill
ext/quicknode-anchorquiknode-labs/solana-anchor-claude-skillAnchor/financial-math/Quasar reference files (quarantined — refs only)
ext/eth-to-solsolana-foundation/eth-to-sol-skillEVM/Solidity → Anchor two-pass porting

Agent Teams

Each agent loads its own specialized context on invocation:

"Use solana-architect to design the vault program"
"Use anchor-engineer to implement the deposit instruction"
"Use defi-engineer to integrate Jupiter swaps"
"Use solana-qa-engineer to write comprehensive tests"

Claude will spawn each specialized agent by itself based on context and, with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS enabled, orchestrate multi-agent workflows:

"Create an agent team: solana-architect for design, anchor-engineer for implementation, solana-qa-engineer for testing"

Recommended team patterns:

PatternFlowUse Case
program-shiparchitect → anchor/pinocchio → qaBuild program from spec to tested
full-stackarchitect → anchor → frontend → qaEnd-to-end feature
audit-and-fixqa → trailofbits context → anchorAudit and remediate
game-shipgame-architect → unity → qaGame feature
defi-composeresearcher → defi-engineer → qaDeFi integration
token-launchtoken-engineer → frontend → qaToken creation + launch UI

MCP Server Integrations

Pre-configured MCP servers in .mcp.json (API keys go in .env):

ServerCapabilities
Helius60+ tools: RPC, DAS API, webhooks, priority fees, token metadata, NFT data
solana-devSolana Foundation official MCP — Solana docs, guides, and API references
Context7Up-to-date library documentation lookup
PlaywrightBrowser automation for dApp testing and visual verification
context-modeContext window optimization — compresses large RPC responses, build logs, and code analysis
memsearchPersistent AI memory across sessions — auto-captures summaries, semantic search, git-friendly storage
SurfpoolAgent-driven local validator / mainnet-fork control via the Surfpool CLI — surfpool mcp (requires the surfpool CLI)

Token-Efficient Design

  • CLAUDE.md is delivered as a user message (not system prompt) — shorter = better adherence
  • Skills load progressively (not all at once)
  • Agents reference skills instead of duplicating content
  • Path-scoped rules lazy-load on file read (zero startup cost)
  • CLAUDE.local.md for private scratch notes (gitignored, never shared)
  • Subdirectory CLAUDE.md files lazy-load in monorepos
  • Decision frameworks live in agents, not global context

Modern Stack (2026)

LayerStack
ProgramsAnchor 1.0+, Pinocchio, Rust 1.82+
Token ExtensionsToken-2022 (transfer hooks, confidential transfers, metadata)
TestingMollusk, LiteSVM, Surfpool, Trident
Frontend@solana/kit, Next.js 15, React 19
MobileReact Native, Expo, Mobile Wallet Adapter
BackendAxum 0.8+, Tokio 1.40+, sqlx
Unity GamesSolana.Unity-SDK, .NET 9, C# 13
PlaySolanaPSG1 console, PlayDex, SvalGuard
DeFiJupiter, Drift, Kamino, Raydium, Orca, Meteora
InfrastructureCloudflare Workers, GitHub Actions, Docker

Extended Skills & Add-on Registry

Beyond the bundled submodules above, the kit ships a curated catalog of opt-in skills, plugins, and MCPs that are not installed by default — the agent installs them only on your request, at your own expense. The set is deduped against solana-new's vendored ecosystem catalogs so it surfaces net-new, high-signal picks rather than restating what's already reachable.

Featured add-ons by domain:

Where we scout new tools (aggregators, not installable): ComposioHQ/awesome-claude-skills · travisvn/awesome-claude-skills · davepoon/buildwithclaude · hesreallyhim/awesome-claude-code · VoltAgent/awesome-claude-code-subagents.

For broader Solana coverage, see solana-new's vendored catalogs at ext/solana-new/cli/data/ (MCPs, skills, clonable repos).

See skill-registry.json for the complete extended catalog — every entry with its install command, license, and safety caveats.

Repository Structure

.
├── CLAUDE.md                    # Main hub - Claude reads this first
├── README.md                    # This file
├── .mcp.json                    # MCP server configurations (project root)
├── install.sh                   # One-liner installer
├── update.sh                    # Deprecation wrapper → .claude/bin/update.sh
├── validate.sh                  # Config integrity checker
├── LICENSE                      # MIT
├── tests/                       # Config integrity test suite
├── .github/workflows/
│   ├── ci.yml                       # PR validation
│   ├── claude-code.yml              # Claude Code action template
│   └── claude.yml                   # @claude mention responder (issues/PRs)
└── .claude/
    ├── VERSION                  # Semver version (e.g. 2.0.0)
    ├── agents/                  # 15 specialized agents
    ├── bin/
    │   ├── update.sh                # In-place update from upstream
    │   └── resync.sh                # Submodule resync script
    ├── commands/                # 29 workflow commands
    ├── skills/                  # Progressive-loading knowledge
    │   ├── SKILL.md                 # Unified hub routing to all skills
    │   ├── ext/                     # External skill submodules
    │   │   ├── solana-dev/              # Solana Foundation dev skill (core)
    │   │   ├── sendai/                  # SendAI protocol skills (DeFi)
    │   │   ├── solana-game/             # Solana game skill (Unity, PSG1)
    │   │   ├── cloudflare/              # Cloudflare Workers, Agents SDK
    │   │   ├── trailofbits/             # Trail of Bits security skills
    │   │   ├── qedgen/                # QEDGen formal verification (Lean 4)
    │   │   ├── solana-mobile/           # Mobile Wallet Adapter, Genesis Token
    │   │   ├── colosseum/              # Colosseum Copilot (startup research)
    │   │   ├── safe-solana-builder/   # Security-first code generation
    │   │   ├── vercel/                # Vercel deployment, Next.js, AI SDK
    │   │   ├── solana-new/            # SendAI idea→launch journey skills + datasets
    │   │   ├── ghostsecurity/         # Ghost Security AppSec skills
    │   │   ├── defending-code/        # Anthropic vuln-discovery reference harness
    │   │   ├── jupiter/               # Official Jupiter skills (swap, lend, VRFD)
    │   │   ├── metaplex/              # Official Metaplex (NFT, candy machine)
    │   │   ├── helius/                # Official Helius infra + SVM internals
    │   │   ├── quicknode-anchor/      # Anchor/Quasar reference files (quarantined)
    │   │   └── eth-to-sol/            # EVM/Solidity → Anchor porting
    │   ├── skill-registry.json     # Opt-in add-on catalog (repos/skills/MCPs)
    │   ├── idea-sprint/             # Wrapper: find + validate crypto ideas (GTM)
    │   ├── pitch-deck/              # Wrapper: pitch decks for crypto projects (GTM)
    │   ├── hackathon/               # Wrapper: hackathon submissions + grants (GTM)
    │   ├── token-2022.md            # Token Extensions guide (local)
    │   ├── backend-async.md         # Axum/Tokio patterns (local)
    │   └── deployment.md            # Deployment workflows (local)
    ├── rules/                   # Auto-loading constraints
    └── settings.json            # Permissions, hooks, agent teams

Agents

AgentPurposeModel
solana-architectSystem design, PDA schemes, token economics, multi-program architectureOpus
anchor-engineerAnchor development, IDL generation, account constraintsOpus
pinocchio-engineerCU optimization (80-95% savings), zero-copy, minimal binaryOpus
defi-engineerDeFi integrations: Jupiter, Drift, Kamino, Raydium, Orca, MeteoraOpus
token-engineerToken-2022 extensions, token economics, launch mechanicsOpus
solana-frontend-engineerReact/Next.js, wallet UX, transaction flows, accessibilityOpus
mobile-engineerReact Native/Expo, mobile wallet adapter, deep linkingSonnet
rust-backend-engineerAxum APIs, indexers, WebSocket servicesOpus
devops-engineerCI/CD, monitoring, RPC infrastructure, Cloudflare WorkersSonnet
solana-qa-engineerTesting (Mollusk/LiteSVM/Trident), CU profiling, code qualityOpus
tech-docs-writerREADMEs, API docs, integration guidesSonnet
game-architectSolana game design, Unity architecture, on-chain game state, PlaySolanaOpus
unity-engineerUnity/C# implementation, Solana.Unity-SDK, wallet integration, NFT displaySonnet
solana-guideLearning, tutorials, concept explanations, progressive learning pathsSonnet
solana-researcherEcosystem research, protocol investigation, SDK analysisSonnet

Commands

Building

CommandPurpose
/build-programBuild Anchor or native Solana program
/build-appBuild Next.js/Vite web client
/build-unityBuild Unity project (WebGL, Desktop, PSG1)
/scaffoldGenerate project scaffolding (program + frontend + tests + CI)

Testing & Quality

CommandPurpose
/test-rustRun Mollusk, LiteSVM, Surfpool, Trident tests
/test-tsRun TypeScript tests (Anchor, Vitest, Playwright)
/test-dotnetRun .NET/C# tests (Unity Test Framework, NUnit)
/test-and-fixRun tests and auto-fix common issues
/audit-solanaComprehensive security audit
/audit-infraInfra-first security audit: secrets, supply chain, CI/CD, LLM/skill security, OWASP, STRIDE
/product-reviewProduct quality review — UX walkthrough, 8-dimension scorecard (--harsh for the roast variant)
/diff-reviewAI-powered diff review for Solana-specific issues
/profile-cuCU profiling per instruction with optimization suggestions
/benchmarkCU benchmarks with before/after comparison
/debug-user-txReplay a user's failing tx against forked state, map error to source

Deployment & Migration

CommandPurpose
/deployDeploy to devnet (always first) or mainnet
/migrate-web3Migrate from @solana/web3.js to @solana/kit
/generate-idl-clientGenerate typed clients from IDL (Codama/Shank)

Workflow & Setup

CommandPurpose
/quick-commitCreate branch, format, lint, conventional commit
/setup-ci-cdConfigure GitHub Actions pipeline
/setup-mcpConfigure MCP server API keys and connections
/resyncResync external skill submodules to latest
/write-docsGenerate documentation for programs, APIs, components
/explain-codeExplain complex code with visual diagrams
/plan-featurePlan feature implementation with specifications
/updateUpdate config to latest version from upstream
/cleanupInitialize forked template — setup CLAUDE.md, remove scaffolding
/doctorHealth check for dev environment + config — read-only, one fix-it command per failure
/dreamMemory consolidation — dedupe, prune, re-rank MEMORY.md and Project Learnings

DX Scripts

ScriptPurpose
install.shOne-liner installer: copies config to your project (--agents for non-Claude tools)
update.shDeprecation wrapper → .claude/bin/update.sh
validate.shValidates all config integrity (agents, commands, skills, settings, versioning)
tests/run_all.shRuns full test suite for config validation

GitHub Action for Team Collaboration

This config includes a pre-built GitHub Action (.github/workflows/claude-code.yml) for PR-based iteration:

  1. Add ANTHROPIC_API_KEY to your repository secrets
  2. Copy .github/workflows/claude-code.yml to your project
  3. Team members can @claude in PR comments
  4. Claude responds with code suggestions using this configuration

Branch Workflow

All new work starts on a feature branch:

# Format: <type>/<scope>-<description>-<DD-MM-YYYY>
git checkout -b feat/program-vault-15-01-2026
git checkout -b fix/frontend-auth-15-01-2026

Use /quick-commit to automate branch creation and commits.

Code Quality

Before merging, run /diff-review or check diff against main:

git diff main...HEAD

Remove: excessive comments, abnormal try/catch blocks, verbose errors, redundant validation.

Keep: legitimate security checks, non-obvious explanations, matching error patterns.

Using as a GitHub Template

  1. Click "Use this template" on GitHub (or fork the repo)
  2. Clone your new repo
  3. Run Claude Code and use /cleanup — this copies CLAUDE-solana.md → CLAUDE.md and removes config repo scaffolding (tests, install scripts, docs)
  4. Start building!

For monorepos, add a CLAUDE.md to each package/module with architecture decisions scoped to that directory. Claude Code automatically loads these when working in that subdirectory.

Updating

# Preferred: use /update in Claude Code, or run directly:
bash .claude/bin/update.sh

# Preview changes without applying:
bash .claude/bin/update.sh --dry-run

# Resync skill submodules only:
bash .claude/bin/resync.sh

# Or manually update submodules
git submodule update --remote --merge

License

MIT - See LICENSE

Ver o original no GitHub

Bom para

Relacionados