Skills, agents, and commands for Claude Code that run a one-sentence idea through a team of AI roles for research, counterarguments, and analogies, and take it to a PRD and clickable HTML prototype.
Claude Code
> /plugin marketplace add majiayu000/spellbook
Codex
$ npx skills add majiayu000/spellbook --skill idea-analogist idea-devils-advocate idea-research idea-team idea-to-product app-ui-design figma-to-react frontend-design ui-design-system agent-qa-testing agentsmd-optimize agentsmd-scaffold api-design app-user-story-qa architecture-foundation architecture-research ascii-backdrop ask-opencli auth-security avoidance-coach blender-editable-3d blender-reference-to-3d build-product-demo capability-distill clash-doctor clash-routes claude-code-reverse cliproxy-newapi-stack code-film codebase-audit codex-agent codex-fluent codex-log-guard codex-retrospective codex comprehensive-testing config-secrets-environments contribution-architect contributor css-debug data-contract-migrations database-patterns dev-architecture-playbook devops-excellence disk-cleaner elegant-architecture figma-to-code flowguard gemma4-local-deploy git-commit-smart github-trending golang-web gpu-use harmonyos-app humanizer illustrated-gallery incident-slo-runbook ip-check model-inference-optimize multi-ai-research multi-model-orchestrator npm-supply-chain-check observability-sre optimize-network performance-capacity playwright-automation prd-master product-analytics product-discovery product-manager-toolkit product-ux-expert project-health-auditor python-project react-best-practices react-hooks-best-practices recap release-engineering repo-agent-context-audit repo-scaffold review-agent-harness review-gate rust-best-practices rust-project rustdesk-doctor security-threat-model server-security skill-audit skill-checkup skill-creator skill-ecosystem-doctor skill-lifeguard skill-usage-stats slides sol-luna-router structured-logging-lite system-doctor systematic-debugging technical-spec threads trip-planner typescript-project ui-designer ui-ux-pro-max vibeguard vscode-doctor web-artifacts-builder web-asset-generator xiaohongshu-netfeel-guardian xiaohongshu xray zig-project -a codex
Cursor
$ npx skills add majiayu000/spellbook --skill idea-analogist idea-devils-advocate idea-research idea-team idea-to-product app-ui-design figma-to-react frontend-design ui-design-system agent-qa-testing agentsmd-optimize agentsmd-scaffold api-design app-user-story-qa architecture-foundation architecture-research ascii-backdrop ask-opencli auth-security avoidance-coach blender-editable-3d blender-reference-to-3d build-product-demo capability-distill clash-doctor clash-routes claude-code-reverse cliproxy-newapi-stack code-film codebase-audit codex-agent codex-fluent codex-log-guard codex-retrospective codex comprehensive-testing config-secrets-environments contribution-architect contributor css-debug data-contract-migrations database-patterns dev-architecture-playbook devops-excellence disk-cleaner elegant-architecture figma-to-code flowguard gemma4-local-deploy git-commit-smart github-trending golang-web gpu-use harmonyos-app humanizer illustrated-gallery incident-slo-runbook ip-check model-inference-optimize multi-ai-research multi-model-orchestrator npm-supply-chain-check observability-sre optimize-network performance-capacity playwright-automation prd-master product-analytics product-discovery product-manager-toolkit product-ux-expert project-health-auditor python-project react-best-practices react-hooks-best-practices recap release-engineering repo-agent-context-audit repo-scaffold review-agent-harness review-gate rust-best-practices rust-project rustdesk-doctor security-threat-model server-security skill-audit skill-checkup skill-creator skill-ecosystem-doctor skill-lifeguard skill-usage-stats slides sol-luna-router structured-logging-lite system-doctor systematic-debugging technical-spec threads trip-planner typescript-project ui-designer ui-ux-pro-max vibeguard vscode-doctor web-artifacts-builder web-asset-generator xiaohongshu-netfeel-guardian xiaohongshu xray zig-project -a cursor
Gemini CLI
$ npx skills add majiayu000/spellbook --skill idea-analogist idea-devils-advocate idea-research idea-team idea-to-product app-ui-design figma-to-react frontend-design ui-design-system agent-qa-testing agentsmd-optimize agentsmd-scaffold api-design app-user-story-qa architecture-foundation architecture-research ascii-backdrop ask-opencli auth-security avoidance-coach blender-editable-3d blender-reference-to-3d build-product-demo capability-distill clash-doctor clash-routes claude-code-reverse cliproxy-newapi-stack code-film codebase-audit codex-agent codex-fluent codex-log-guard codex-retrospective codex comprehensive-testing config-secrets-environments contribution-architect contributor css-debug data-contract-migrations database-patterns dev-architecture-playbook devops-excellence disk-cleaner elegant-architecture figma-to-code flowguard gemma4-local-deploy git-commit-smart github-trending golang-web gpu-use harmonyos-app humanizer illustrated-gallery incident-slo-runbook ip-check model-inference-optimize multi-ai-research multi-model-orchestrator npm-supply-chain-check observability-sre optimize-network performance-capacity playwright-automation prd-master product-analytics product-discovery product-manager-toolkit product-ux-expert project-health-auditor python-project react-best-practices react-hooks-best-practices recap release-engineering repo-agent-context-audit repo-scaffold review-agent-harness review-gate rust-best-practices rust-project rustdesk-doctor security-threat-model server-security skill-audit skill-checkup skill-creator skill-ecosystem-doctor skill-lifeguard skill-usage-stats slides sol-luna-router structured-logging-lite system-doctor systematic-debugging technical-spec threads trip-planner typescript-project ui-designer ui-ux-pro-max vibeguard vscode-doctor web-artifacts-builder web-asset-generator xiaohongshu-netfeel-guardian xiaohongshu xray zig-project -a gemini-cli
GitHub Copilot
$ npx skills add majiayu000/spellbook --skill idea-analogist idea-devils-advocate idea-research idea-team idea-to-product app-ui-design figma-to-react frontend-design ui-design-system agent-qa-testing agentsmd-optimize agentsmd-scaffold api-design app-user-story-qa architecture-foundation architecture-research ascii-backdrop ask-opencli auth-security avoidance-coach blender-editable-3d blender-reference-to-3d build-product-demo capability-distill clash-doctor clash-routes claude-code-reverse cliproxy-newapi-stack code-film codebase-audit codex-agent codex-fluent codex-log-guard codex-retrospective codex comprehensive-testing config-secrets-environments contribution-architect contributor css-debug data-contract-migrations database-patterns dev-architecture-playbook devops-excellence disk-cleaner elegant-architecture figma-to-code flowguard gemma4-local-deploy git-commit-smart github-trending golang-web gpu-use harmonyos-app humanizer illustrated-gallery incident-slo-runbook ip-check model-inference-optimize multi-ai-research multi-model-orchestrator npm-supply-chain-check observability-sre optimize-network performance-capacity playwright-automation prd-master product-analytics product-discovery product-manager-toolkit product-ux-expert project-health-auditor python-project react-best-practices react-hooks-best-practices recap release-engineering repo-agent-context-audit repo-scaffold review-agent-harness review-gate rust-best-practices rust-project rustdesk-doctor security-threat-model server-security skill-audit skill-checkup skill-creator skill-ecosystem-doctor skill-lifeguard skill-usage-stats slides sol-luna-router structured-logging-lite system-doctor systematic-debugging technical-spec threads trip-planner typescript-project ui-designer ui-ux-pro-max vibeguard vscode-doctor web-artifacts-builder web-asset-generator xiaohongshu-netfeel-guardian xiaohongshu xray zig-project -a github-copilot
OpenCode
$ npx skills add majiayu000/spellbook --skill idea-analogist idea-devils-advocate idea-research idea-team idea-to-product app-ui-design figma-to-react frontend-design ui-design-system agent-qa-testing agentsmd-optimize agentsmd-scaffold api-design app-user-story-qa architecture-foundation architecture-research ascii-backdrop ask-opencli auth-security avoidance-coach blender-editable-3d blender-reference-to-3d build-product-demo capability-distill clash-doctor clash-routes claude-code-reverse cliproxy-newapi-stack code-film codebase-audit codex-agent codex-fluent codex-log-guard codex-retrospective codex comprehensive-testing config-secrets-environments contribution-architect contributor css-debug data-contract-migrations database-patterns dev-architecture-playbook devops-excellence disk-cleaner elegant-architecture figma-to-code flowguard gemma4-local-deploy git-commit-smart github-trending golang-web gpu-use harmonyos-app humanizer illustrated-gallery incident-slo-runbook ip-check model-inference-optimize multi-ai-research multi-model-orchestrator npm-supply-chain-check observability-sre optimize-network performance-capacity playwright-automation prd-master product-analytics product-discovery product-manager-toolkit product-ux-expert project-health-auditor python-project react-best-practices react-hooks-best-practices recap release-engineering repo-agent-context-audit repo-scaffold review-agent-harness review-gate rust-best-practices rust-project rustdesk-doctor security-threat-model server-security skill-audit skill-checkup skill-creator skill-ecosystem-doctor skill-lifeguard skill-usage-stats slides sol-luna-router structured-logging-lite system-doctor systematic-debugging technical-spec threads trip-planner typescript-project ui-designer ui-ux-pro-max vibeguard vscode-doctor web-artifacts-builder web-asset-generator xiaohongshu-netfeel-guardian xiaohongshu xray zig-project -a opencode
Windsurf
$ npx skills add majiayu000/spellbook --skill idea-analogist idea-devils-advocate idea-research idea-team idea-to-product app-ui-design figma-to-react frontend-design ui-design-system agent-qa-testing agentsmd-optimize agentsmd-scaffold api-design app-user-story-qa architecture-foundation architecture-research ascii-backdrop ask-opencli auth-security avoidance-coach blender-editable-3d blender-reference-to-3d build-product-demo capability-distill clash-doctor clash-routes claude-code-reverse cliproxy-newapi-stack code-film codebase-audit codex-agent codex-fluent codex-log-guard codex-retrospective codex comprehensive-testing config-secrets-environments contribution-architect contributor css-debug data-contract-migrations database-patterns dev-architecture-playbook devops-excellence disk-cleaner elegant-architecture figma-to-code flowguard gemma4-local-deploy git-commit-smart github-trending golang-web gpu-use harmonyos-app humanizer illustrated-gallery incident-slo-runbook ip-check model-inference-optimize multi-ai-research multi-model-orchestrator npm-supply-chain-check observability-sre optimize-network performance-capacity playwright-automation prd-master product-analytics product-discovery product-manager-toolkit product-ux-expert project-health-auditor python-project react-best-practices react-hooks-best-practices recap release-engineering repo-agent-context-audit repo-scaffold review-agent-harness review-gate rust-best-practices rust-project rustdesk-doctor security-threat-model server-security skill-audit skill-checkup skill-creator skill-ecosystem-doctor skill-lifeguard skill-usage-stats slides sol-luna-router structured-logging-lite system-doctor systematic-debugging technical-spec threads trip-planner typescript-project ui-designer ui-ux-pro-max vibeguard vscode-doctor web-artifacts-builder web-asset-generator xiaohongshu-netfeel-guardian xiaohongshu xray zig-project -a windsurf
Quick Start • Runtime Targets • Pick a Workflow • Skills • Agents • Changelog • Release Status • Contributing • 中文
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.
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.
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
/ to see your installed skills.~/.agents/skills.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.
.agents/skills in Claude CodeChecked 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.
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.
python3 scripts/validate_skills.py --check.references/, templates/, scripts/, and eval files instead of one giant prompt.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.
# 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
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.
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 |
Stars on GitHub
View @majiayu000’s profileGives you a team of AI helpers for a rough product idea: one researches real data, one argues against it, and one offers cross-industry comparisons, then a coach walks the idea through to a PRD and clickable prototype.
@majiayu000A development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraHelps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookInstall it with the command on its page. It includes idea-analogist, idea-devils-advocate, idea-research. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it