CLAUDE.md — superstack

What This Is

Skills and knowledge base to ship on Solana — Idea to Launch. 33 journey skills, 106 repos, 79 ecosystem skills, 36 MCP servers.

Install

curl -fsSL https://www.solanaskills.com/setup.sh | bash

Usage

Users invoke skills directly via Claude Code:

claude "/find-next-crypto-idea What should I build?"
claude "/scaffold-project Set up my workspace"
claude "/deploy-to-mainnet Ship it"

Journey Skills

33 skills across 4 phases — user just asks naturally, right skill activates.

Skills live in skills/<phase>/<skill-name>/. To add a new skill, create a folder with SKILL.md + references/ + agents/openai.yaml.

Skill routing: skills/SKILL_ROUTER.md is a shared routing table. Each SKILL.md references it so the AI can auto-correct if the wrong skill is invoked.

Shared guides (step-by-step commands):

• skills/data/guides/rpc-wallet-guide.md — RPC + wallet setup for dev and production
• skills/data/guides/deploy-runbook.md — Deploy devnet → mainnet with verification
• skills/data/guides/security-checklist.md — P0-P3 security audit with exact grep commands

What's Indexed

File Map

cli/
  branding.ts               Single source of truth for all brand strings
  index.ts                  Command dispatcher, agent output, help
  telemetry.ts              Skill usage tracking (Convex + local JSONL)
  init.ts                   Auto-install skills to ~/.claude/skills/ and ~/.codex/skills/
  data/
    clonable-repos.json     106 repos (Solana official, SendAI, Metaplex, DeFi, etc.)
    solana-skills.json      79 skills (15 official + 64 community)
    solana-mcps.json        36 MCP servers
skills/
  SKILL_ROUTER.md           Shared routing table — AI auto-corrects wrong skill
  idea/                     Discovery & planning skills (7 skills, includes solana-beginner, learn)
  build/                    Implementation skills (20 skills, includes virtual-solana-incubator, roast-my-product, product-review, cso, page-load-animations, animation-reverse-engineering, number-formatting, design-taste, verify-humanity-poh)
  launch/                   Go-to-market skills (6 skills, includes marketing-video, apply-grant, video-craft)
  data/
    guides/                 Shared guides (RPC+wallet, deploy, security, curated ideas)
    solana-knowledge/       6 knowledge area docs + cookbook index (covers all of solana.com)
    specs/                  Phase handoff JSON contracts
    ideas/                  114+ curated ideas from YC, a16z, Alliance, Superteam
    defi/                   DefiLlama OpenAPI spec
convex/
  schema.ts                 Feedback + telemetry tables
  feedback.ts               Feedback submission mutation
  telemetry.ts              Skill usage tracking mutation + queries
setup                       One-command install script

Conventions

• ESM-only: All imports use .js extensions (NodeNext module resolution)
• Strict TypeScript: strict mode, no implicit any
• No runtime deps: Only devDependencies (tsx, typescript, @types/node) + convex
• Agent-first: Designed for agent consumption
• Single source of truth: All branding in cli/branding.ts

This project uses Convex as its backend.

When working on Convex code, always read convex/_generated/ai/guidelines.md first for important guidelines on how to correctly use Convex APIs and patterns. The file contains rules that override what you may have learned about Convex from training data.

Convex agent skills for common tasks can be installed by running npx convex ai-files install.