---

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
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
figma-to-code	Figma designs to production React/Next.js with TypeScript and Tailwind
css-debug	Diagnose CSS/layout issues, Tailwind conflicts, z-index stacking
playwright-automation	Browser automation and testing with Playwright

Tooling & Automation

Skill	Description
web-asset-generator	Favicons, app icons, OG images
github-trending	GitHub trending analysis
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
codex-log-guard	Diagnose and mitigate excessive Codex local SQLite diagnostic log writes
server-security	Audit and harden Linux server SSH, firewall, and exposed services
cliproxy-newapi-stack	Add a loopback-first NewAPI metering layer to an independently verified CLIProxyAPI upstream

Operations & Deploy

Deploy models and diagnose local and remote environments.

Skill	Description
gemma4-local-deploy	Deploy Gemma 4 12B locally on Mac/Apple Silicon via llama.cpp or Ollama
gpu-use	Inspect remote server GPU usage (per-card VRAM, processes, containers)
rustdesk-doctor	Diagnose RustDesk connection issues
vscode-doctor	Diagnose slow or freezing VS Code-compatible editors

Content & Social Media

Skill	Description
xiaohongshu	Xiaohongshu content creation & publishing
trip-planner	Travel itinerary planning
weekly	Weekly report from Git, Claude Code, and Codex sessions
xiaohongshu-netfeel-guardian	Remove translation-tone from Claude's Chinese content for native readability

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
Spellbook Operating Contract	Agent behavior rules for autonomy, escalation, pushback, feedback loops, and done-when checks
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:

• Bugs: open an issue
• Feature ideas: open a feature request
• Security vulnerabilities: follow Security Policy

---

Credits

Built on the shoulders of giants:

• anthropics/skills - Official Anthropic skills
• obra/superpowers - Development methodology
• claude-code-plugins-plus - Plugin hub
• VoltAgent/awesome-claude-code-subagents - Agent collection

---

Contributing

Contributions welcome! Please read our Contributing Guide first.

• Found a bug? Open an issue
• Have a skill idea? Open a feature request
• Want to contribute? Submit a PR

---

The Agent Infra Stack

This project is one layer of an open-source stack for running coding agents (Claude Code, Codex) as serious infrastructure. Every piece works standalone; together they close the loop:

spellbook sits in the Extend layer — the authoring side of the skill story: write once, run on Claude Code and Codex. Discovery and distribution live in claude-skill-registry.

Layer	Project	What it does
Extend	claude-skill-registry	Discover and search community Claude Code skills
Extend	spellbook ◀ you are here	Cross-runtime skills for Claude Code, Codex, and multi-agent workflows
Trust	argus	Static install-time scanner for supply-chain attacks (npm / PyPI / crates.io)
Trust	vibeguard	Rules, hooks, and guards against hallucinated or unverified agent changes
Remember	remem	Local-first persistent memory for Claude Code and Codex sessions
Orchestrate	harness	Rust agent orchestration platform — rules, skills, GC, observability
Route	litellm-rs	High-performance Rust AI gateway — 100+ LLM APIs via OpenAI format
Keep	keepline	Session command center — monitor, recover, never lose agent work

---

License

MIT License - Use freely in your projects.

---