Skip to content
Back to search

solana-dev-skill

Skills for agentic development on Solana

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/solana-foundation-solana-dev-skill/badge.svg)](/listings/solana-foundation-solana-dev-skill)

HTML

<a href="/listings/solana-foundation-solana-dev-skill"><img src="/api/listings/solana-foundation-solana-dev-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Quick install (any agent, via skills.sh)

npx skills add solana-foundation/solana-dev-skill

The [skills CLI](https://www.skills.sh/) detects your installed agents and installs (or symlinks) the skill for each of them.

Install script

git clone https://github.com/solana-foundation/solana-dev-skill
cd solana-dev-skill
./install.sh            # user-level: ~/.agents/skills + ~/.claude/skills
./install.sh --project  # project-level: .agents/skills + .claude/skills
./install.sh --link     # symlink instead of copy (auto-updates with git pull)

Manual install

Copy (or symlink) `skills/solana-dev/` into your agent's skills directory:

| Agent | Project directory | Personal directory | |---|---|---| | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | OpenAI Codex / ChatGPT desktop | `.agents/skills/` | `~/.agents/skills/` | | GitHub Copilot (CLI, coding agent, VS Code) | `.github/skills/` or `.agents/skills/` | `~/.copilot/skills/` or `~/.agents/skills/` | | Gemini CLI | `.gemini/skills/` or `.agents/skills/` | `~/.gemini/skills/` or `~/.agents/skills/` | | Cursor | `.cursor/skills/` or `.agents/skills/` | `~/.cursor/skills/` or `~/.agents/skills/` | | Windsurf | `.windsurf/skills/` or `.agents/skills/` | `~/.codeium/windsurf/skills/` | | Cline | `.cline/skills/` or `.claude/skills/` | `~/.cline/skills/` | | OpenCode | `.opencode/skills/` or `.agents/skills/` | `~/.config/opencode/skills/` |

`.agents/skills/` (cross-agent convention) plus `.claude/skills/` together cover all of the above.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Solana Development Skill
  2. <p align="center">
  3. <img src="assets/banner.png" alt="solana-dev — npx skills add solana-dev — skill installed, 8 agents" width="100%" />
  4. </p>
  5. A comprehensive [Agent Skill](https://agentskills.io/) for modern Solana development (July 2026 best practices). Works with every coding agent that has direct Agent Skills support: **Claude Code, OpenAI Codex / ChatGPT desktop, GitHub Copilot (CLI + coding agent), Gemini CLI, Cursor, Windsurf, Cline, OpenCode**, and anything else that reads `SKILL.md`.
  6. ## Overview
  7. This skill gives your coding agent deep knowledge of the current Solana development ecosystem:
  8. - **SDK**: `@solana/kit` 8 plugin clients (`createClient()` + `.use()`), building transaction v1 by default
  9. - **UI**: Wallet Standard connection via `@solana/kit-plugin-wallet` + `@solana/react`
  10. - **Legacy Interop**: web3.js v3 — the classic API rebuilt on Kit internals, as the migration target for v1 codebases
  11. - **Programs**: Anchor 1.2.x (default), Pinocchio 0.11+ for high-performance needs
  12. - **Testing**: Surfpool for integration tests (mainnet forking, cheatcodes, embedded SDK), LiteSVM/Mollusk for unit tests
  13. - **Codegen**: Codama-first IDL and client generation
  14. - **Security**: Comprehensive vulnerability patterns and prevention
  15. - **Toolchain**: Version compatibility, common errors, and troubleshooting guides
  16. ## Installation
  17. ### Quick install (any agent, via skills.sh)
  18. ```bash
  19. npx skills add solana-foundation/solana-dev-skill
  20. ```
  21. The [skills CLI](https://www.skills.sh/) detects your installed agents and installs (or symlinks) the skill for each of them.
  22. ### Install script
  23. ```bash
  24. git clone https://github.com/solana-foundation/solana-dev-skill
  25. cd solana-dev-skill
  26. ./install.sh # user-level: ~/.agents/skills + ~/.claude/skills
  27. ./install.sh --project # project-level: .agents/skills + .claude/skills
  28. ./install.sh --link # symlink instead of copy (auto-updates with git pull)
  29. ```
  30. ### Desktop app upload
  31. Download `solana-dev.zip` from the [latest release](https://github.com/solana-foundation/solana-dev-skill/releases/latest/download/solana-dev.zip) and upload it as a custom skill in your application. Don't use GitHub's "Code → Download ZIP": that archive nests `SKILL.md` too deep for the uploader to find.
  32. ### Manual install
  33. Copy (or symlink) `skills/solana-dev/` into your agent's skills directory:
  34. | Agent | Project directory | Personal directory |
  35. |---|---|---|
  36. | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
  37. | OpenAI Codex / ChatGPT desktop | `.agents/skills/` | `~/.agents/skills/` |
  38. | GitHub Copilot (CLI, coding agent, VS Code) | `.github/skills/` or `.agents/skills/` | `~/.copilot/skills/` or `~/.agents/skills/` |
  39. | Gemini CLI | `.gemini/skills/` or `.agents/skills/` | `~/.gemini/skills/` or `~/.agents/skills/` |
  40. | Cursor | `.cursor/skills/` or `.agents/skills/` | `~/.cursor/skills/` or `~/.agents/skills/` |
  41. | Windsurf | `.windsurf/skills/` or `.agents/skills/` | `~/.codeium/windsurf/skills/` |
  42. | Cline | `.cline/skills/` or `.claude/skills/` | `~/.cline/skills/` |
  43. | OpenCode | `.opencode/skills/` or `.agents/skills/` | `~/.config/opencode/skills/` |
  44. `.agents/skills/` (cross-agent convention) plus `.claude/skills/` together cover all of the above.
  45. ## Skill Structure
  46. ```
  47. skills/solana-dev/
  48. ├── SKILL.md # Main skill definition (required)
  49. └── references/
  50. ├── kit/ # @solana/kit: overview, plugins, react, codecs, accounts, codama, gotchas, advanced, programs/
  51. ├── frontend.md # UI patterns (Kit wallet plugin + @solana/react)
  52. ├── kit-web3-interop.md # Legacy web3.js routing (v3 + migration skill)
  53. ├── testing.md # Testing (Surfpool/LiteSVM/Mollusk)
  54. ├── idl-codegen.md # IDL and client generation
  55. ├── tokens.md # Token concepts (SPL Token vs Token-2022, authorities, delegation, extensions)
  56. ├── payments.md # Payments (Kit, Solana Pay, Kora)
  57. ├── kora.md # Kora paymaster: gasless / sponsored fees, operator setup
  58. ├── keychain.md # Solana Keychain: server-side signing (KMS, Vault, MPC, managed wallets)
  59. ├── mosaic.md # Mosaic: Token-2022 issuance templates, sRFC-37 allow/block lists
  60. ├── security.md # Security vulnerabilities & prevention
  61. ├── concepts.md # Runtime concepts (rent, PDAs, entrypoint, wire format)
  62. ├── resources.md # Curated reference links
  63. ├── compatibility-matrix.md # Version compatibility tables (Anchor/Solana/Rust/GLIBC)
  64. ├── common-errors.md # Error message → solution mappings
  65. ├── confidential-transfers.md # Confidential transfers (Token-2022 ZK)
  66. ├── rpc-quick-lookups.md # One-shot RPC reads via curl
  67. ├── transactions-v1.md # Transaction v1 / larger transactions (SIMD-0385)
  68. ├── programs/
  69. │ ├── anchor.md # Anchor program development
  70. │ ├── design-patterns.md # Program architecture, CU/CPI limits, account lifecycle
  71. │ └── pinocchio.md # Pinocchio (high-performance native)
  72. ├── anchor/
  73. │ └── migrating-v0.32-to-v1.md # Anchor v1 migration
  74. └── surfpool/
  75. ├── overview.md # Surfpool local network guide
  76. ├── kit-plugin.md # @solana/surfpool/kit — embedded surfnet behind a Kit client
  77. └── cheatcodes.md # Surfpool cheatcodes reference (26 surfnet_* methods)
  78. ```
  79. ## Usage
  80. Once installed, your agent will automatically use this skill when you ask about:
  81. - Solana dApp UI work (React / Next.js)
  82. - Wallet connection and signing flows
  83. - Transaction building, sending, and confirmation UX
  84. - Transaction v1 / larger transactions (SIMD-0385) — the default format for new code; sending, reading, indexing
  85. - On-chain program development (Anchor or Pinocchio)
  86. - Client SDK generation (typed program clients)
  87. - Local testing (Surfpool, LiteSVM, Mollusk)
  88. - Security hardening and audit-style reviews
  89. - Surfpool local network setup and cheatcodes
  90. - Gasless / sponsored-fee transactions (Kora), server-side signing (Solana Keychain), and regulated token issuance (Mosaic)
  91. - **Toolchain issues** (version mismatches, GLIBC errors, dependency conflicts)
  92. - **Migration** between Anchor/Solana CLI versions, and web3.js v1 → v3
  93. ### Example Prompts
  94. ```
  95. "Help me set up a Next.js app with Solana wallet connection"
  96. "Create an Anchor program for a simple escrow"
  97. "Convert this Anchor program to Pinocchio for better CU efficiency"
  98. "Migrate this web3.js v1 script to web3.js v3"
  99. "Write Surfpool integration tests for my token transfer flow"
  100. "Review this program for security issues"
  101. "I'm getting GLIBC_2.39 not found when running anchor"
  102. "Help me upgrade from Anchor 0.32 to 1.2"
  103. "What versions of Solana CLI work with Anchor 1.2?"
  104. "Run Surfpool and create an account with 100 SOL and USDC"
  105. ```
  106. ## Stack Decisions
  107. This skill encodes opinionated best practices:
  108. | Layer | Default Choice | Alternative |
  109. |-------|---------------|-------------|
  110. | Client SDK | @solana/kit 8 (plugin clients, transaction v1) | web3.js v3 (legacy migration target) |
  111. | Wallet / UI | @solana/kit-plugin-wallet + @solana/react | Wallet Standard hooks directly |
  112. | Program Framework | Anchor 1.2.x | Pinocchio 0.11+ (performance) |
  113. | Unit Testing | LiteSVM / Mollusk | — |
  114. | Integration Testing | Surfpool (CLI or embedded @solana/surfpool) | solana-test-validator |
  115. | Client Generation | Codama | — |
  116. ## Content Sources
  117. This skill incorporates best practices from:
  118. - [Blueshift Learning Platform](https://learn.blueshift.gg/) - Comprehensive Solana courses
  119. - [Solana Official Documentation](https://solana.com/docs)
  120. - [Solana Kit](https://www.solanakit.com/) - Kit docs and plugin ecosystem
  121. - [solana-web3.js v3](https://github.com/solana-foundation/solana-web3.js) - Classic API on Kit internals
  122. - [Anza/Pinocchio](https://github.com/anza-xyz/pinocchio) - Zero-dependency program development
  123. - [LiteSVM](https://github.com/LiteSVM/litesvm) - Lightweight testing
  124. - [Surfpool](https://docs.surfpool.run/) - Integration testing with mainnet state
  125. ## Progressive Disclosure
  126. The skill follows the [Agent Skills](https://agentskills.io/specification) progressive disclosure pattern: the main `SKILL.md` provides core guidance, and agents read the specialized markdown files under `references/` only when needed for specific tasks.
  127. ## Benchmarks
  128. `tests/run.ts` contains a small benchmark suite that checks skill trigger matching and MCP auto-install behavior:
  129. ```bash
  130. cd tests && npm install && npx tsx run.ts
  131. ```
  132. ## Contributing
  133. Contributions are welcome! Please ensure any updates reflect current Solana ecosystem best practices.
  134. 1. Fork the repository
  135. 2. Create a feature branch
  136. 3. Make your changes
  137. 4. Submit a pull request
  138. ## License
  139. MIT License - see [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.