Skip to main content
ClaudeWave
Skill97 repo starsupdated 1mo ago

solana-dev

The solana-dev skill hub routes Solana development tasks to specialized resources covering program development with Anchor, frontend integration via the Solana Kit, testing frameworks, security practices, Token-2022 extensions, and DeFi protocol integrations including Jupiter, Drift, Raydium, and others. Use this skill when building any Solana application to quickly locate canonical patterns, framework documentation, and protocol-specific guidance.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/solanabr/solana-ai-kit /tmp/solana-dev && cp -r /tmp/solana-dev/.claude/skills ~/.claude/skills/solana-dev
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Solana Development Skill Hub

Routes to the right skill file based on the task. Read the relevant section, follow the link, load that skill.

**Source precedence (when multiple skills cover one topic):**
1. `.claude/rules/*` are law for code style — always win (checked math, PDA bumps, no `unwrap()`/`init_if_needed`, reload-after-CPI, naming). No skill overrides a rule on style.
2. Protocol-OFFICIAL skill is primary for that protocol's API/SDK usage (jup-ag→Jupiter, metaplex-foundation→Metaplex, helius-labs→Helius).
3. Foundation/platform skills (solana-dev) are primary for general concepts (Anchor, Pinocchio, testing, clients).
4. sendai/community versions are secondary references — routed only when the official/foundation source lacks coverage.

One primary per row: each Task-Routing row points to exactly ONE primary target; secondaries live in section bodies, not the routing table.

## Core Solana Development

**Primary entry point** — read first for any Solana program, frontend, testing, or client task:

- [ext/solana-dev/skill/SKILL.md](ext/solana-dev/skill/SKILL.md) — Solana Foundation skill (framework-kit-first, Kit types, wallet-standard)

Key references within:
- [programs/anchor.md](ext/solana-dev/skill/references/programs/anchor.md) — Anchor patterns, IDL, constraints (canonical)
- [programs/pinocchio.md](ext/solana-dev/skill/references/programs/pinocchio.md) — Zero-copy, CU optimization (canonical)
- [frontend-framework-kit.md](ext/solana-dev/skill/references/frontend-framework-kit.md) — React hooks, wallet connection, @solana/kit UI
- [kit-web3-interop.md](ext/solana-dev/skill/references/kit-web3-interop.md) — Kit ↔ web3.js boundary patterns
- [testing.md](ext/solana-dev/skill/references/testing.md) — LiteSVM, Mollusk, Surfpool, CI
- [security.md](ext/solana-dev/skill/references/security.md) — Vulnerability categories, checklists
- [idl-codegen.md](ext/solana-dev/skill/references/idl-codegen.md) — Codama/Shank client generation
- [payments.md](ext/solana-dev/skill/references/payments.md) — Commerce Kit, Kora, Solana Pay
- [resources.md](ext/solana-dev/skill/references/resources.md) — Official documentation links

## Token Extensions

- [token-2022.md](token-2022.md) — SPL Token-2022 extensions: transfer hooks, confidential transfers, transfer fees, metadata, CPI guard, soulbound tokens, and all extension types with Anchor/native patterns

## DeFi & Ecosystem Protocols

**Official protocol skills (primary — precedence tier 2).** Protocol-maintained skills win for that protocol's own API/SDK usage:

| Protocol | Skill | Use for |
|----------|-------|---------|
| Jupiter | [integrating-jupiter/](ext/jupiter/skills/integrating-jupiter/SKILL.md) | Swap, Lend, Perps, Trigger, Recurring, Tokens, Price, Send, Studio — endpoint selection + integration flows |
| Jupiter (swap migration) | [jupiter-swap-migration/](ext/jupiter/skills/jupiter-swap-migration/SKILL.md) | Metis/legacy → Ultra v1 swap API migration |
| Jupiter (lend) | [jupiter-lend/](ext/jupiter/skills/jupiter-lend/SKILL.md) | Jupiter Lend borrow/supply flows |
| Jupiter (VRFD) | [jupiter-vrfd/](ext/jupiter/skills/jupiter-vrfd/SKILL.md) | Verifiable randomness for fair distribution |
| Metaplex | [metaplex/](ext/metaplex/skills/metaplex/SKILL.md) | NFT standards: Core, Token Metadata, Bubblegum (cNFT), Candy Machine, Genesis, Umi/Kit, mplx CLI |
| Helius | [helius/](ext/helius/helius-skills/helius/SKILL.md) | RPC, Sender, DAS API, WebSockets/Laserstream, webhooks, priority fees (home repo of the helius MCP we ship) |
| SVM internals | [svm/](ext/helius/helius-skills/svm/SKILL.md) | Solana architecture deep-dive: SVM execution, account model, consensus, validator economics, Agave/Firedancer source, SIMDs |

Secondary references (sendai/community — routed only if the official source lacks coverage): `ext/sendai/skills/jupiter/`, `ext/sendai/skills/metaplex/`, `ext/sendai/skills/helius/` (older copies; the official skills above supersede them). sendai's `helius-dflow`/`helius-phantom` integration layers are superseded by the official Helius repo's own dflow/phantom skills under `ext/helius/helius-skills/`.

Other protocol skills from [SendAI](ext/sendai/skills/):

| Protocol | Skill | Use for |
|----------|-------|---------|
| Phoenix | [phoenix/](ext/sendai/skills/phoenix/) | Perpetual futures (Rise SDK) |
| Ranger Finance | [ranger-finance/](ext/sendai/skills/ranger-finance/) | Perps aggregation, leverage routing |
| Lavarage | [lavarage/](ext/sendai/skills/lavarage/) | Leveraged trading for any SPL token |
| Raydium | [raydium/](ext/sendai/skills/raydium/) | AMM, CLMM pools |
| Meteora | [meteora/](ext/sendai/skills/meteora/) | DLMM, dynamic pools |
| Orca | [orca/](ext/sendai/skills/orca/) | Whirlpools, concentrated liquidity |
| Kamino | [kamino/](ext/sendai/skills/kamino/) | Lending, vaults |
| Marginfi | [marginfi/](ext/sendai/skills/marginfi/) | Lending protocol |
| Sanctum | [sanctum/](ext/sendai/skills/sanctum/) | LST staking |
| PumpFun | [pumpfun/](ext/sendai/skills/pumpfun/) | Token launch |
| Pyth | [pyth/](ext/sendai/skills/pyth/) | Price oracles |
| Switchboard | [switchboard/](ext/sendai/skills/switchboard/) | Oracles, VRF |
| Squads | [squads/](ext/sendai/skills/squads/) | Multisig |
| DeBridge | [debridge/](ext/sendai/skills/debridge/) | Cross-chain bridging |
| LI.FI | [lifi/](ext/sendai/skills/lifi/) | Cross-chain swaps, bridging, route discovery |
| Arcium | [arcium/](ext/sendai/skills/arcium/) | Encrypted compute: dark pools, sealed-bid auctions |
| Light Protocol | [light-protocol/](ext/sendai/skills/light-protocol/) | ZK compression |
| Birdeye | [birdeye/](ext/sendai/skills/birdeye/) | Real-time DeFi data, prices, OHLCV |
| Wallet Analysis | [wallet-analysis/](ext/sendai/skills/wallet-analysis/) | Portfolio value, positions, PnL (Zerion) |
| Carbium | [carbium/](ext/sendai/skills/carbium/) | Bare-metal RPC, gRPC streaming, DEX aggregation |
| SOL Incinerator | [sol-incinerator/](ext/sendai/skills/
anchor-engineerSubagent

Anchor framework specialist for rapid Solana program development. Use for building programs with Anchor macros, IDL generation, account validation, and standardized patterns. Prioritizes developer experience while maintaining security.\\n\\nUse when: Building new programs quickly, team projects needing standardization, projects requiring IDL for client generation, or when developer experience is prioritized over maximum CU optimization.

defi-engineerSubagent

DeFi integration specialist for composing with Solana protocols including Jupiter, Drift, Kamino, Raydium, Orca, Meteora, Marginfi, and Sanctum. Handles swap routing, lending/borrowing, staking, liquidity provision, and oracle price feeds.\n\nUse when: Integrating DeFi protocols, building swap interfaces, implementing lending/borrowing, setting up yield strategies, working with Pyth/Switchboard oracles, or composing multi-protocol transactions.

devops-engineerSubagent

CI/CD, infrastructure, and deployment specialist for Solana projects. Handles GitHub Actions, Docker, monitoring, RPC management, and Cloudflare Workers edge deployment.\n\nUse when: Setting up CI/CD pipelines, containerizing Solana validators or programs, configuring monitoring and alerting, managing RPC infrastructure, deploying edge workers, or automating build and deploy workflows.

game-architectSubagent

Senior Solana game architect for game system design, Unity/C# architecture, on-chain game state, player progression, NFT integration, and PlaySolana ecosystem. Use for high-level game design decisions, architecture reviews, and planning complex game systems.\n\nUse when: Designing new Solana games from scratch, planning game state on-chain, Unity project architecture, integrating with PlaySolana/PSG1, or deciding between implementation approaches.

mobile-engineerSubagent

React Native and Expo specialist for building Solana mobile dApps. Handles mobile wallet adapter integration, transaction signing UX, deep linking, and mobile-specific performance optimization.\n\nUse when: Building React Native or Expo mobile apps with Solana integration, implementing mobile wallet adapter flows, setting up deep links for transaction signing, or optimizing mobile dApp performance.

pinocchio-engineerSubagent

CU optimization specialist using Pinocchio framework. Use for performance-critical programs requiring 80-95% CU reduction vs Anchor. Specializes in zero-copy access, manual validation, and minimal binary size.\\n\\nUse when: CU limits are being hit, transaction costs are significant at scale, binary size must be minimized, or maximum throughput is required.

rust-backend-engineerSubagent

Rust backend specialist for building async services that interact with Solana blockchain. Builds APIs, indexing services, and off-chain processing using Axum, Tokio, and modern async patterns.\n\nUse when: Building REST/WebSocket APIs for Solana dApps, implementing transaction indexers, creating webhook services, or any Rust backend that interacts with Solana.

solana-architectSubagent

Senior Solana program architect for system design, account structures, PDA schemes, token economics, and cross-program composability. Use for high-level design decisions, architecture reviews, and planning complex multi-program systems.\n\nUse when: Designing new programs from scratch, planning account structures, optimizing PDA schemes, reviewing architecture for security, or deciding between implementation approaches.