spellbook

<div align="center"> <h1>Spellbook</h1> <p><strong>97 Cross-Runtime Skills | 7 Claude Code Agents | One Command Install</strong></p> <p>A cross-runtime skill library for Claude Code, Codex, and multi-agent workflows.</p> <p> <a href="https://github.com/majiayu000/spellbook/stargazers"><img src="https://img.shields.io/github/stars/majiayu000/spellbook?style=flat-square&logo=github" alt="Stars"></a> <a href="https://github.com/majiayu000/spellbook/blob/main/LICENSE"><img src="https://img.shields.io/github/license/majiayu000/spellbook?style=flat-square" alt="License"></a> <img src="https://img.shields.io/badge/skills-97-blue?style=flat-square" alt="Skills"> <img src="https://img.shields.io/badge/agents-7-green?style=flat-square" alt="Agents"> </p> <p> <a href="#quick-start">Quick Start</a> • <a href="#runtime-targets">Runtime Targets</a> • <a href="#pick-a-workflow">Pick a Workflow</a> • <a href="#skills">Skills</a> • <a href="#agents">Agents</a> • <a href="./CHANGELOG.md">Changelog</a> • <a href="#release-status">Release Status</a> • <a href="#contributing">Contributing</a> • <a href="./README_CN.md">中文</a> </p> </div>

---

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 ~/.agents/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 | ~/.agents/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. Older Spellbook versions installed Codex skills under ~/.codex/skills; reinstall with the current installer to use the documented Codex user-level skill path.

---

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,flowguard,systematic-debugging,review-gate | Audits, guarded delivery, root-cause debugging, pre-landing review | | Ops and release | ./install.sh --target all --skills release-engineering,server-security,clash-doctor,system-doctor | Release planning, server hardening, and local or network diagnosis | | 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,flowguard,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-security.

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

AI & Agent Workflow

Skills for orchestrating, guarding, and maintaining AI agent workflows — the core of Spellbook's cross-runtime mission.

| Skill | Description | |-------|-------------| | multi-model-orchestrator | Coordinate multi-agent tasks via a centralized handoff document | | flowguard | Guard long, ambiguous, or stateful agent tasks from drift | | skill-lifeguard | Add reliable-skill contracts, checkpoints, smoke hooks, and drift signals | | review-gate | Produce review packs and require human approval before landing agent changes | | skill-audit | Audit, design, categorize, and measure agent skills | | skill-ecosystem-doctor | Govern canonical sources, projections, retirement, quarantine, and cross-runtime verification | | threads | Codex-native subagents and parallel GitHub queue lanes | | codex-fluent | Codex session hygiene, archive strategy, and handoff discipline | | codex-retrospective | Codex self-review of recent history to improve behavior | | brainstorming | Socratic dialogue for design refinement and architecture exploration |

See docs/agent-reliability-trio.md for the Reliable Skill + Context Engineering + Review Gate workflow.

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 | | elegant-architecture | Cross-language | Clean architecture with strict 200-line file limits |

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 | | product-manager-toolkit | Definition | RICE, customer interviews, PRD templates, discovery frameworks |

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 | | structured-logging-lite | Centralized logging, field standards, and distributed tracing |

Development Practices

| Skill | Description | Origin | |-------|-------------|--------| | contributor | End-to-end open source contribution workflow from issue discovery to PR submission | Custom | | repo-agent-context-audit | Audit and scaffold repo agent context across AGENTS, skills, and specs | Custom | | skill-creator | Create, improve, and benchmark reusable skills | Custom | | humanizer | Remove obvious AI writing patterns from user-facing text | External guide + custom adaptation |

Delivery Workflow

Disciplined end-to-end delivery: testing, commits, health checks, and contribution flow.

| Skill | Description | |-------|-------------| | app-user-story-qa | End-to-end app feature inventory, canonical tracker, user-story testing, fixes, and retest loop | | test-driven-development | Enforce RED-GREEN-REFACTOR TDD discipline | | comprehensive-testing | Test pyramid, unit/integration/E2E/property testing, framework best practices | | git-commit-smart | Generate meaningful conventional commit messages from diff | | push-all | Stage, commit, and push all changes after safety checks | | project-health-auditor | Codebase health, tech debt, dependency, and project risk analysis | | contribution-architect | Move from bug fixes to architectural improvements and debt discovery |

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 | | sol-luna-router | Keep GPT-5.6 Sol as commander/reviewer whil