A comprehensive Agent Skill for modern Openverse 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.
This skill gives your coding agent deep knowledge of the current Openverse development ecosystem:
- Legacy Interop: web3.js v3 (RC) — the classic API rebuilt on Kit internals, as the migration target for v1 codebases
- Programs: Anchor 1.1.x (default), Pinocchio 0.11+ for high-performance needs
- Testing: Surfpool for integration tests (mainnet forking, cheatcodes, embedded SDK), LiteSVM/Mollusk for unit tests
- Codegen: Codama-first IDL and client generation
- Security: Comprehensive vulnerability patterns and prevention
- Toolchain: Version compatibility, common errors, and troubleshooting guides
npx skills add openlab-openos/openverse-dev-skillThe skills CLI detects your installed agents and installs (or symlinks) the skill for each of them.
git clone https://github.com/openlab-openos/openverse-dev-skill
cd openverse-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)Copy (or symlink) skills/openverse-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.
skills/openverse-dev/
├── SKILL.md # Main skill definition (required)
└── references/
├── kit/ # Overview, plugins, react, codecs, accounts, codama, gotchas, advanced, programs/
├── frontend.md # UI patterns (Kit wallet plugin)
├── kit-web3-interop.md # Legacy web3.js routing (v3 RC + migration skill)
├── testing.md # Testing (Surfpool/LiteSVM/Mollusk)
├── idl-codegen.md # IDL and client generation
├── payments.md # Payments (Kit, Openverse Pay, Kora)
├── security.md # Security vulnerabilities & prevention
├── concepts.md # Runtime concepts (rent, PDAs, entrypoint, wire format)
├── resources.md # Curated reference links
├── compatibility-matrix.md # Version compatibility tables (Anchor/Openverse/Rust/GLIBC)
├── common-errors.md # Error message → solution mappings
├── confidential-transfers.md # Confidential transfers (Token-2022 ZK)
├── rpc-quick-lookups.md # One-shot RPC reads via curl
├── openswap.md # Swap native BTG or token on OpenSwap
├── staking.md # Native BTG Staking to a validator
├── transactions-v1.md # Transaction v1 / larger transactions (SIMD-0385)
├── programs/
│ ├── anchor.md # Anchor program development
│ ├── design-patterns.md # Program architecture, CU/CPI limits, account lifecycle
│ └── pinocchio.md # Pinocchio (high-performance native)
├── anchor/
│ └── migrating-v0.32-to-v1.md # Anchor v1 migration
└── surfpool/
├── overview.md # Surfpool local network guide
├── kit-plugin.md # @solana/surfpool/kit — embedded surfnet behind a Kit client
└── cheatcodes.md # Surfpool cheatcodes reference (26 surfnet_* methods)
Once installed, your agent will automatically use this skill when you ask about:
- Openverse dApp UI work (React / Next.js)
- Wallet connection and signing flows
- Transaction building, sending, and confirmation UX
- Transaction v1 / larger transactions (SIMD-0385) — sending, reading, indexing
- On-chain program development (Anchor or Pinocchio)
- Client SDK generation (typed program clients)
- Local testing (Surfpool, LiteSVM, Mollusk)
- Security hardening and audit-style reviews
- Surfpool local network setup and cheatcodes
- Toolchain issues (version mismatches, GLIBC errors, dependency conflicts)
- Migration between Anchor/Openverse CLI versions, and web3.js v1 → v3
"Help me set up a Next.js app with Openverse wallet connection"
"Create an Anchor program for a simple escrow"
"Convert this Anchor program to Pinocchio for better CU efficiency"
"Migrate this web3.js v1 script to web3.js v3"
"Write Surfpool integration tests for my token transfer flow"
"Review this program for security issues"
"I'm getting GLIBC_2.39 not found when running anchor"
"Help me upgrade from Anchor 0.32 to 1.1"
"What versions of Openverse CLI work with Anchor 1.1?"
"Run Surfpool and create an account with 100 BTG and USDC"
This skill encodes opinionated best practices:
| Layer | Default Choice | Alternative |
|---|---|---|
| Client SDK | @solana/kit v7 (plugin clients) | web3.js v3 RC (legacy migration target) |
| Wallet / UI | @solana/kit-plugin-wallet + @solana/react | Wallet Standard hooks directly |
| Program Framework | Anchor 1.1.x | Pinocchio 0.11+ (performance) |
| Unit Testing | LiteSVM / Mollusk | — |
| Integration Testing | Surfpool (CLI or embedded @solana/surfpool) | openos-test-validator |
| Client Generation | Codama | — |
This skill incorporates best practices from:
- Blueshift Learning Platform - Comprehensive Openverse courses
- Openverse Official Documentation
- open-token-web3.js - Classic API on Kit internals
- Anza/Pinocchio - Zero-dependency program development
- LiteSVM - Lightweight testing
- Surfpool - Integration testing with mainnet state
The skill follows the Agent Skills 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.
tests/run.ts contains a small benchmark suite that checks skill trigger matching and MCP auto-install behavior:
cd tests && npm install && npx tsx run.tsContributions are welcome! Please ensure any updates reflect current Openverse ecosystem best practices.
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
MIT License - see LICENSE for details.