spellbook

Name: spellbook
Author: majiayu000

Verified

Cross-runtime skills for Claude Code, Codex, and multi-agent workflows.

227stars

21forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/majiayu000/spellbook

Getting Started

Guides for using ai agents skills like spellbook.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 6/4/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-06-04T08:21:14.501Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is spellbook?

spellbook is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by majiayu000. Cross-runtime skills for Claude Code, Codex, and multi-agent workflows. It has 227 GitHub stars.

Is spellbook safe to use?

Yes. spellbook passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install spellbook?

Clone the repository with "git clone https://github.com/majiayu000/spellbook" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is spellbook written in?

spellbook is primarily written in Python. It is open-source under majiayu000 on GitHub, so you can review or fork the full source.

Are there alternatives to spellbook?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh spellbook against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

seobuild-onpage testdriverai

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,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

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-audit`	Audit, design, categorize, and measure agent skills
`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
`personal-arsenal-lifecycle-doctor`	Diagnose the health of personal `~/.claude/skills`

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`	Log architecture, standards, observability, and tracing
`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
`strategic-compact`	C