Spellbook Agent Skill

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

---

Use .agents/skills in Claude Code

Checked on October 7, 2026: Claude Code's instruction documentation supports AGENTS.md directly from v2.1.277. By default it loads these files only when no CLAUDE.md, .claude/CLAUDE.md, or CLAUDE.local.md exists in the working directory or its ancestors. You can choose to load both in the Project instructions setting. If direct support is unavailable, put @AGENTS.md in a neighboring CLAUDE.md.

Skills use separate discovery paths: the documented locations include .claude/skills and ~/.claude/skills, but not .agents/skills. For a repository that already keeps its skills in .agents/skills, run this from the repository root only if .claude/skills does not already exist, including as a symlink:

mkdir -p .claude
ln -s ../.agents/skills .claude/skills

Both paths now expose the same directory. Changes affect both tools, so you cannot add a Claude-only skill there. If you already have .claude/skills, keep it and link only the shared skill instead (replace my-skill with an existing skill directory):

ln -s ../../.agents/skills/my-skill .claude/skills/my-skill

The official skills documentation supports individual skill-directory symlinks. On macOS, Claude Code 2.1.234 listed a test skill in its CLI initialization event with either link layout; without a link, the same command was unknown. Model execution could not be verified because that installation was not logged in. Restart Claude Code, check / for your skill, and invoke it to verify your own environment.

On Windows, directory symlinks use mklink /D, and creating symlinks can require Developer Mode or Administrator privileges. Git's core.symlinks setting also affects checkout. Windows loading was not tested here; teams can use separate target entries instead:

# From a Spellbook checkout; installs selected skills at user scope
./install.sh --target all --skills typescript-project,python-project

# Or use the skills CLI and select Claude Code and Codex when prompted
npx skills add majiayu000/spellbook --skill typescript-project

The installer creates entries in ~/.claude/skills and ~/.agents/skills pointing to its shared source checkout. It does not synchronize arbitrary project directories. These instructions describe local Claude Code CLI use; other session types can have different loading rules.

---

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-checkup	Find broken, drifted, competing and one-sided skills across Claude Code and Codex
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
model-inference-optimize	Profile and optimize model inference with quality and cost checks, using anonymized cases
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
agent-qa-testing	Web/mobile regression runs and triage with advanced memidex memory and self-improvement
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
loop-close	Close the loop on a feature, study or experiment: name the decision it supports and the quit condition up front, then end with adopt / reject / needs-evidence and archive it
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 while GPT-5.6 Luna performs bounded implementation
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
illustrated-gallery	Illustrated website template with full-frame ASCII transitions
ascii-backdrop	Animated ASCII backdrop from any subject: glyph, edge, shape-matched, braille, dither or tile modes, cursor glow, CRT finish, text decode and image dissolve
code-built-3d	Build 3D scenes from code-made parts and take them apart: technical-illustration render, isometric camera moves, shell removal, exploded views with a parts list, endless chunked generation; demo is an endless apartment tower
form-motion	Ten restrained, hand-following UI micro-interactions (morphing button, liquid tab indicator, elastic slider, command palette, drag reorder and more), each with its prompt, knobs and an automated pointer/keyboard acceptance script
hud-interface	Game-HUD style pages: ink-and-paper with one accent, slanted tags, giant outline numbers, ring text, tilted cards, a liquid-marble shader backdrop, and optional HTML-in-Canvas glass panels with a plain-DOM fallback
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
blender-editable-3d	Editable Blender models from references or concepts, with part-level edits and verified exports
blender-reference-to-3d	Reference analysis, Blender character modeling, color, multiview review, and editable delivery
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
avoidance-coach	Self-help coach for breaking avoidance loops (CBT/DBT/ACT, not therapy)
code-film	Make story-driven animated short films from pure code: a three.js HTML file whose picture and sound are functions of time, rendered offline to MP4, with the Clawd character included
motion-stack	Code-made motion films: pick the fewest of 20 open-source libraries, write a scene whose picture and sound are pure functions of time, render headless to MP4 with purity check, auto loudness (-14 LUFS) and a reproducibility manifest
repo-film	Turn a repo's real commits over any time window into a short film: main line and branches grow as a flowchart with true forks and merges, optionally collapse into its you-are-here project map; one command to MP4
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

---

Plugins

Spellbook is also a Claude Code plugin marketplace. Install the repo as a marketplace, then install plugins from it:

/plugin marketplace add majiayu000/spellbook
/plugin install idea-coach
/plugin install rust-dev

Plugin	Description
idea-coach	Opinionated product coach (idea -> PRD -> clickable HTML prototype) + multi-role idea group chat; plugin commands are /idea-coach:idea and /idea-coach:idea-team
rust-dev	Rust best practices, code review, performance, and async patterns

Plugin skills are packaged copies of catalog skills; the catalog (installed by install.sh) remains the cross-runtime source of truth.

---

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. The first numbered tag is v0.1.0. The install path remains 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.

---

<div align="center"> <p>If this helps you, consider giving it a ⭐</p> <p>Made for builders using Claude Code, Codex, and multi-agent workflows</p> </div>