Spellbook
majiayu000/spellbook
83 skills reutilizáveis para Claude Code, Codex e agentes
Ver no GitHubBiblioteca de 83 skills reutilizáveis para Claude Code, Codex e fluxos multi-agente. Oferece instalação centralizada e selecionável de skills especializadas em desenvolvimento, qualidade de código, design, DevOps e outras áreas, com suporte cross-runtime.
Instalação
npx convez-ai majiayu000/spellbook1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolver projetos frontend com design systems
- Auditar código e corrigir bugs sistematicamente
- Automatizar fluxos de DevOps e infraestrutura
- Acelerar workflows multi-agente com skills pré-construídas
- Construir aplicações UI/UX com handoff Figma
Veredito

Spellbook é um repositório maduro de skills reutilizáveis bem estruturado, com instalação simples e ampla cobertura de cenários (frontend, DevOps, qualidade de código). Recomendado para quem trabalha regularmente com Claude Code ou Codex e quer padronizar workflows.
README
A tradução para o português deste README ainda está na fila.
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
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 |
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 |
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 |
Development Practices
| Skill | Description | Origin |
|---|---|---|
contributor | End-to-end open source contribution workflow from issue discovery to PR submission | Custom |
strategic-compact | Compress context at logical boundaries while preserving decisions and constraints | Custom |
skill-creator | Create, improve, and benchmark reusable skills | Custom |
humanizer | Remove obvious AI writing patterns from user-facing text | External guide + custom adaptation |
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 |
Tooling & Automation
| Skill | Description |
|---|---|
web-asset-generator | Favicons, app icons, OG images |
github-trending | GitHub trending analysis |
auto-optimize | Autonomous codebase optimization with dimension rotation |
fixflow | Strict plan-implement-test-commit workflow for delivery tasks |
optflow | Optimization discovery and execution workflow with continuous validation |
plan-flow | Repository-level redundancy analysis with step-test-update planning |
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 |
server-deploy | Deploy Node, Python, Rust, Go, or static projects to remote servers |
server-security | Audit and harden Linux server SSH, firewall, and exposed services |
cliproxy-deploy | Deploy router-for-me/CLIProxyAPI on a Linux VPS, exposing Codex/Claude/Gemini OAuth subscription accounts as an OpenAI-compatible API |
cliproxy-newapi-stack | Layer NewAPI metering on top of CLIProxyAPI: Docker deploy, ratio-based pricing, quota top-up, dual-path verification, and OAuth account hot-swap |
Content & Social Media
| Skill | Description |
|---|---|
xiaohongshu | Xiaohongshu content creation & publishing |
trip-planner | Travel itinerary planning |
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:
- Hard Rules - Mandatory constraints with
FORBIDDEN/REQUIREDmarkers - Practical Examples - Real code, not just theory
- Verification Checklists - Actionable validation steps
- 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
License
MIT License - Use freely in your projects.