spellbook

<div align="center"> <h1>Spellbook</h1> <p><strong>109 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-109-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

Start with one job-shaped workflow. The maintained skills CLI lets you choose the supported coding agents during installation and installs only these four skills:

npx skills add majiayu000/spellbook --skill frontend-design --skill app-ui-design --skill ui-design-system --skill figma-to-react

Use npx skills add majiayu000/spellbook --list to inspect the catalog before installing. See Pick a Workflow for four other focused starting points.

Advanced Cross-Runtime Installer

install.sh remains available when you want explicit Claude Code/Codex target paths or need to install the repository's Claude Code agents as well as skills.

# Install all skills and supported agents into both maintained runtimes
curl -fsSL https://raw.githubusercontent.com/majiayu000/spellbook/main/install.sh | bash -s -- --target all

# Or clone the repository and select skills explicitly
git clone https://github.com/majiayu000/spellbook.git
cd spellbook
./install.sh --target all --skills typescript-project,python-project,devops-excellence

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 | npx skills add majiayu000/spellbook --skill frontend-design --skill app-ui-design --skill ui-design-system --skill figma-to-react | Product UI, landing pages, design systems, Figma handoff | | Code quality | npx skills add majiayu000/spellbook --skill codebase-audit --skill flowguard --skill systematic-debugging --skill review-gate | Audits, guarded delivery, root-cause debugging, pre-landing review | | Ops and release | npx skills add majiayu000/spellbook --skill release-engineering --skill server-security --skill clash-doctor --skill system-doctor | Release planning, server hardening, and local or network diagnosis | | Product and docs | npx skills add majiayu000/spellbook --skill product-discovery --skill prd-master --skill technical-spec --skill product-analytics | Discovery, PRDs, technical specs, metrics plans | | Agent workflows | npx skills add majiayu000/spellbook --skill codex-agent --skill multi-ai-research --skill flowguard --skill 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. Use the Spellbook Skill Browser for curated first-party skills, or the Claude Skills Registry for broader community discovery. 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 be