Skip to content

README.md

Latest commit

 

History

History
345 lines (251 loc) · 16.5 KB

README.md

File metadata and controls

345 lines (251 loc) · 16.5 KB

Spellbook

83 Cross-Runtime Skills | 7 Claude Code Agents | One Command Install

A cross-runtime skill library for Claude Code, Codex, and multi-agent workflows.

Stars License Skills Agents

Quick Start • Runtime Targets • Pick a Workflow • Skills • Agents • Changelog • Release Status • Contributing • 中文

Rename notice: Spellbook was formerly Claude Arsenal. Claude Code remains a first-class target; the new name reflects the broader roadmap for Claude Code, Codex, and cross-runtime agent skills. See the migration note for details.

Quick Start

One-Line Install (All Skills)

curl -fsSL https://raw.githubusercontent.com/majiayu000/spellbook/main/install.sh | bash -s -- --target all

Manual Install (Selective)

# Clone the repository
git clone https://github.com/majiayu000/spellbook.git
cd spellbook

# Install specific skills for Claude Code and Codex
./install.sh --target all --skills typescript-project,python-project,devops-excellence

# Or install everything for one runtime
./install.sh --target claude --all
./install.sh --target codex --all

Verify Installation

  • Claude Code: type / to see your installed skills.
  • Codex: restart Codex so it reloads ~/.codex/skills.

Runtime Targets

Spellbook keeps the skill source in one place and installs it into the runtime you use.

Target Installed To Status
Claude Code ~/.claude/skills plus ~/.claude/agents Skills and agents supported
Codex ~/.codex/skills Skills supported; agents skipped
All Both Claude Code and Codex paths Recommended for multi-tool users

Claude Code remains a first-class target and search entry. The project was formerly known as Claude Arsenal; the new Spellbook name reflects the broader goal: reusable skills that can travel across coding agents.

Pick a Workflow

Start with a small bundle that matches the job, then add more skills when the workflow sticks.

Workflow Install Good for
Frontend and UI ./install.sh --target all --skills frontend-design,app-ui-design,ui-design-system,figma-to-react Product UI, landing pages, design systems, Figma handoff
Code quality ./install.sh --target all --skills codebase-audit,fixflow,optflow,systematic-debugging Audits, bug fixes, refactors, root-cause debugging
Ops and deploy ./install.sh --target all --skills server-deploy,server-security,clash-doctor,system-doctor Shipping apps, hardening servers, diagnosing local and network issues
Product and docs ./install.sh --target all --skills product-discovery,prd-master,technical-spec,product-analytics Discovery, PRDs, technical specs, metrics plans
Agent workflows ./install.sh --target all --skills codex-agent,multi-ai-research,strategic-compact,vibeguard Cross-review, multi-AI research, context handoff, anti-hallucination checks

High-signal individual skills to try first: github-trending, harmonyos-app, app-ui-design, product-discovery, xiaohongshu, codebase-audit, and server-deploy.

See Showcase for copy-paste prompts and expected outputs. Release history lives in Changelog.

Why Spellbook

  • Cross-runtime install: one source tree can install into Claude Code and Codex.
  • Validated registry: every installable skill is checked by python3 scripts/validate_skills.py --check.
  • Progressive disclosure: larger skills use references/, templates/, scripts/, and eval files instead of one giant prompt.
  • Practical coverage: engineering, operations, product, UI, content, and agent workflows live in one catalog.

Skills

The generated full skill inventory lives in Skill Registry. Skill layout rules live in Skill Format Policy. Skill authoring quality rules live in Skill Quality Playbook.

Search the Registry

# Free-text query (AND semantics across name, description, category, tags)
python3 scripts/validate_skills.py search rust testing

# Filter by tag
python3 scripts/validate_skills.py search --tag agent

# Restrict to a description language
python3 scripts/validate_skills.py search --language zh deploy

# Machine-readable output
python3 scripts/validate_skills.py search --tag react --json

The tag index lives in registry/tags.json for tooling and dashboards. Curated overrides for skills the keyword heuristic cannot infer live in registry/tag_overrides.yml.

Audit non-blocking skill quality signals:

python3 scripts/audit_skill_quality.py
python3 scripts/audit_skill_quality.py skill-creator

Development Architecture

Build production-ready projects with language-specific best practices.

Skill Language Key Features
typescript-project TypeScript ESM, Zod, Biome, Clean Architecture
python-project Python uv, Pydantic, Ruff, FastAPI
rust-project Rust Cargo workspace, error handling, async
golang-web Go Chi/Echo, sqlc, structured logging
zig-project Zig Build system, memory management
architecture-foundation Cross-language Runtime, state ownership, adapters, and convergence specs

Product Lifecycle

End-to-end product development from discovery to deployment.

Skill Phase What You Get
product-discovery Discovery JTBD, user interviews, market research
prd-master Definition PRD writing, user stories, RICE prioritization
technical-spec Design Design docs, ADR, C4 diagrams
product-analytics Growth Event tracking, A/B testing, AARRR
devops-excellence Deployment CI/CD, Docker, Kubernetes, GitOps
observability-sre Operations Monitoring, logging, tracing, SLO/SLI

API & Backend

Skill Description
api-design REST/GraphQL/gRPC patterns, OpenAPI 3.2
auth-security OAuth 2.1, JWT, security best practices
database-patterns PostgreSQL, Redis, migrations, optimization
codebase-audit Deep adaptive repository audit with severity-ranked findings and repair roadmap

Development Practices

Skill Description Origin
contributor End-to-end open source contribution workflow from issue discovery to PR submission Custom
strategic-compact Compress context at logical boundaries while preserving decisions and constraints Custom
skill-creator Create, improve, and benchmark reusable skills Custom
humanizer Remove obvious AI writing patterns from user-facing text External guide + custom adaptation

Cross-Tool Interop

Skills for using multiple coding agents and CLI tools together.

Skill Description
codex Invoke Codex CLI sessions from another agent workflow
codex-agent Optional second-opinion review, cross-verification, and alternatives through Codex CLI
ask-opencli Ask Grok or Gemini through opencli and an existing browser session
multi-ai-research Parallel research across multiple AI tools and internal agents

UI/UX & Design

Skill Description
app-ui-design iOS/Android UI design, Material Design 3, HIG
product-ux-expert UX evaluation, heuristics, accessibility
frontend-design Web frontend design patterns
ui-designer Extract design systems from UI screenshots and references
ui-design-system Design system toolkit and design-dev handoff support
web-artifacts-builder Claude.ai HTML artifacts
react-best-practices React and Next.js performance patterns distilled from Vercel guidance
react-hooks-best-practices React hooks, effects, refs, and component design patterns
slides Speech-friendly slide deck and background slide generation
ui-ux-pro-max Compact UI/UX tables for product patterns, landing pages, charts, and 9 stacks

Tooling & Automation

Skill Description
web-asset-generator Favicons, app icons, OG images
github-trending GitHub trending analysis
auto-optimize Autonomous codebase optimization with dimension rotation
fixflow Strict plan-implement-test-commit workflow for delivery tasks
optflow Optimization discovery and execution workflow with continuous validation
plan-flow Repository-level redundancy analysis with step-test-update planning
vibeguard Task contracts, finding scoring, and lightweight anti-hallucination reviews
clash-doctor Clash proxy & network diagnostics
clash-routes Inspect active proxy routes for specific processes via Mihomo API
optimize-network Safe local network speed, latency, DNS, Wi-Fi, and bufferbloat diagnostics with VPN/proxy guardrails
disk-cleaner Scan and reclaim disk space with interactive cleanup guidance
system-doctor Diagnose CPU, memory, and process-level system slowdowns
server-deploy Deploy Node, Python, Rust, Go, or static projects to remote servers
server-security Audit and harden Linux server SSH, firewall, and exposed services
cliproxy-deploy Deploy router-for-me/CLIProxyAPI on a Linux VPS, exposing Codex/Claude/Gemini OAuth subscription accounts as an OpenAI-compatible API
cliproxy-newapi-stack Layer NewAPI metering on top of CLIProxyAPI: Docker deploy, ratio-based pricing, quota top-up, dual-path verification, and OAuth account hot-swap
claude-mem Orchestrator-driven planning & execution

Content & Social Media

Skill Description
xiaohongshu Xiaohongshu content creation & publishing
trip-planner Travel itinerary planning

Mobile & Cross-Platform

Skill Description
harmonyos-app HarmonyOS with ArkTS, ArkUI, Stage Model

Rust Specific

Skill Description
rust-best-practices Microsoft Rust guidelines, error handling

Agents

Specialized agents for complex tasks.

Agent Expertise Use Case
tech-lead-orchestrator Coordination Multi-step tasks, delegation
code-archaeologist Exploration Legacy codebase documentation
backend-typescript-architect Architecture Bun/Node.js, API design
senior-code-reviewer Review Security, performance, architecture
kubernetes-specialist Infrastructure K8s, Helm, GitOps
security-auditor Security OWASP Top 10, SAST
opensource-contributor Contribution Open source workflow

Skill Design Philosophy

Every skill in Spellbook follows these principles:

  1. Hard Rules - Mandatory constraints with FORBIDDEN / REQUIRED markers
  2. Practical Examples - Real code, not just theory
  3. Verification Checklists - Actionable validation steps
  4. Battle-Tested - Used in production environments

Documentation

Document Description
Changelog Release history and current release status
Installation Guide Detailed setup instructions
Runtime Targets Claude Code and Codex installation targets
Showcase Copy-paste workflow demos
Skill Format Policy Directory vs file skill layout rules
Skill Quality Playbook Trigger descriptions, gotchas, progressive disclosure, and verification
Skill Testing Guide How to validate skills work
Creating Plugins Build your own skills
Product Lifecycle (EN) Full lifecycle coverage
Product Lifecycle (中文) 产品生命周期覆盖

Release Status

Spellbook is in pre-1.0 release-readiness mode. No numbered GitHub release tag has been cut yet; the current install path uses the repository main branch. See Changelog for release history.

Current limitations:

  • Codex installs skills only; Claude Code agents are skipped for Codex targets.
  • Some skills depend on external CLIs, accounts, credentials, or platform access that are not bundled by the installer.
  • The registry validator checks installable skill structure, not every external workflow end to end.

Support paths:

Credits

Built on the shoulders of giants:

Contributing

Contributions welcome! Please read our Contributing Guide first.

License

MIT License - Use freely in your projects.

If this helps you, consider giving it a ⭐

Made for builders using Claude Code, Codex, and multi-agent workflows