Does spellbook auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

spellbook

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

FLOW.md

majiayu000@majiayu000

GitHub

Plugin Signal86/100Strong

maintained98

capable97

documented75

adopted51

Install

$ npx -y skills add majiayu000/spellbook --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

Python TypeScript JavaScript React CSS

+7 tags

Rust Kubernetes GitHub Anthropic OpenAI Gemini Figma

258

Stars

Forks

Active

Maintenance

Python

Language

MIT

License

4d ago

Last commit

8mo ago

Created

Repo: majiayu000/spellbook

In this plugin

93 skills 10 agents

See everything inside

What's inside

Skills

/agentsmd-optimizeAudit AND optimize a CLAUDE.md / AGENTS.md instruction file — score it against the five high-leverage patterns, flag anti-patterns, then apply approved fixes in place. Use when the user says 优化 CLAUDE.md / 优化 AGENTS.md / optimize my agent doc / 帮我改 claudemd, or after an audit /agentsmd-scaffoldGenerate or update repository-specific AGENTS.md instruction files from real repo evidence. Use when asked to create, design, scaffold, split, or improve root or scoped AGENTS.md files for Codex/Claude/agent workflows, especially when a repo needs directory-specific rules,/api-designREST/GraphQL/gRPC API design best practices. Use when designing APIs, defining contracts, handling versioning. Covers OpenAPI 3.2, GraphQL Federation, gRPC streaming./app-ui-designMobile app UI design expert for iOS and Android. Use when designing app interfaces, creating design systems, ensuring accessibility, or following platform guidelines. Covers Material Design 3, Human Interface Guidelines, color theory, typography, and 2025 trends./app-user-story-qaEnd-to-end app feature inventory and user-story testing workflow with a canonical tracker. Use when the user asks to audit every feature, derive expected behavior from code, test user journeys, or explicitly fix and retest documented UX or logistical defects./architecture-foundationDesign architecture foundations before implementation. Use when asked to design or refactor architecture, choose Rust/Go crate, package, module, runtime, workflow, or service boundaries, compare mature project architecture, prevent stacked one-off PRs, audit migration debt in

Show all 93 skills

/ask-opencliAsk Grok or Gemini via opencli (browser-session based, no API cost). Use when the user says "问 grok", "问 gemini", "ask grok", "ask gemini", "用 grok 查", "grok 怎么看", "让 gemini 分析", or wants a second opinion from Grok/Gemini without paying API tokens. Routes to opencli which drives /auth-securityOAuth 2.1 + JWT authentication security best practices. Use when implementing auth, API authorization, token management. Follows RFC 9700 (2025)./capability-distill能力蒸馏工作流——从用户批准的强模型访谈或真实任务轨迹中提取非显然的判断规则，形成可审计的 judgment packet，再交给 skill-audit 和 skill-creator 决定是否落成可加载 skill。当用户说“蒸馏这个模型的判断力”“把这次任务的关键决策固化下来”“模型窗口要关了，保留它在某类场景的判断”时使用。普通流程文档、直接写 SKILL.md、泛化最佳实践或未授权的会话日志扫描不使用本 skill。/clash-doctorClash Verge 诊断与配置管理。网络诊断、配置 AI 工具路由规则（Claude/Codex/Cursor/Warp）、查看/克隆订阅配置、切换配置文件。当用户遇到网络问题、要配置代理规则、切换订阅、查看 Clash 配置时使用 /clash-routes查看指定进程的代理线路。通过 Mihomo API 查询当前活跃连接，显示进程匹配的规则和代理链路。用于确认某个进程（如 claude、chrome）走的是哪条订阅线路 /claude-code-reverse对用户拥有或明确获授权的本机可执行文件、应用二进制和版本产物做只读静态逆向，包括 Claude Code 及其他 CLI、Mach-O、ELF、PE、Wasm 或打包应用。仅在用户明确要求“逆向、扒实现、查二进制字符串/符号/依赖、验证内部行为、比较两个版本”时使用；不要因普通提及软件而触发，也不要用于执行未知样本、绕过授权/计费、破解或再分发。/cliproxy-newapi-stack在已经过独立验证的 CLIProxyAPI upstream 之上部署 NewAPI 计费层，把 Codex/Claude/Gemini/Qwen 等订阅账号包装成可计费的 OpenAI 兼容 API。本 Skill 不负责新建裸 CLIProxyAPI；负责 NewAPI Docker 部署、容器到宿主桥接、模型计费倍率、参数化额度修正、多账号 OAuth 凭据热加载和双路径验证。当用户说“给现有 cliproxy 加 NewAPI”“配置 NewAPI 渠道接已运行的 cliproxy”“NewAPI /codebase-audit全面代码库审计 — 自适应并行深度分析（前后端契约、数据完整性、异常处理/安全、架构/技术债、配置/缓存），结构化 findings + 对抗验证 + 基线对比，输出按严重程度排序的统一报告和修复路线图。支持 quick 快速体检模式。Use when user asks to audit, analyze, or review an entire codebase for design issues, find hidden bugs, check architecture health, or asks '全面审查', '代码库审计',/codex-agentUse when you want a second-opinion review via Codex CLI, cross-verification after another agent implements changes, debugging help, or alternative implementation proposals. Requires Codex CLI to be installed and authenticated./codex-fluentUse when Codex feels slow, bloated, or heavy after heavy use. Provides safe session hygiene, archive strategy, and handoff discipline to keep daily Codex usage responsive and low-friction. Always pairs with comprehensive handoffs before archiving active work./codex-log-guardDiagnose excessive Codex local SQLite diagnostic log writes with read-only evidence by default. Use when a user mentions logs_2.sqlite, logs_2.sqlite-wal, block_log_inserts, SSD/TBW wear, or explicitly asks to protect, clean up, verify, or restore Codex diagnostic logging./codex-retrospectiveUse when you want Codex to review its own recent history (last N days or specific period) and improve its behavior. Produces minimal, high-signal updates to AGENTS.md and tiny reusable skills. The goal is long-term fluency — Codex gradually becomes better at your specific style,/codexUse when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing /comprehensive-testingComplete testing strategy covering TDD workflow, test pyramid, unit/integration/E2E/property testing, framework best practices (Jest, Vitest, pytest), mock strategies, and CI integration. Use when writing tests, reviewing test quality, or establishing testing standards./config-secrets-environmentsDesign, audit, and verify configuration, environment separation, secrets, BYOK flows, key rotation, config schema validation, and drift checks across local, dev, staging, and production. Use when adding env vars, changing runtime config, handling API keys or user-provided keys,/contribution-architectUse when a contributor wants to move beyond simple bug fixes into architectural improvements, technical debt discovery, design proposals, or module ownership opportunities./contributorEnd-to-end open source contribution workflow: from scanning issues to submitting PRs. Use this skill whenever the user wants to contribute to an open source project, find issues to fix, submit a pull request, fork a repo to contribute, fix a GitHub issue, or mentions 'open /css-debugUse this skill to diagnose CSS and frontend layout issues such as positioning, overflow clipping, Tailwind class conflicts, z-index stacking, and React rendering visibility problems./data-contract-migrationsDesign and verify data contracts, schema changes, migrations, rollbacks, backfills, compatibility windows, tenant isolation, and API-to-database field mapping. Use when changing database schema, event payloads, persisted documents, analytics tables, multi-tenant data boundaries,/database-patternsUse when designing PostgreSQL + Redis data models, indexes, caching strategies, JSONB usage, tiered storage, or cache consistency contracts./dev-architecture-playbookRoute full software-development architecture work from product intent through design, implementation, testing, release, and operations. Use when the user asks for a complete development architecture, wants to know which Spellbook skills to combine, needs an execution path across /devops-excellenceDevOps and CI/CD expert. Use when setting up pipelines, containerizing applications, deploying to Kubernetes, or implementing release strategies. Covers GitHub Actions, Docker, K8s, Terraform, and GitOps./disk-cleaner当用户要扫描磁盘空间、找出可安全删除的缓存/编译产物/安装包、或交互式释放空间时使用。/elegant-architectureGuides clean architecture design with strict 200-line file limits. Use when starting new features, refactoring large files, or planning module structure. Enforces modular design and real testing./figma-to-codeExtract Figma designs and generate production-ready React/Next.js components with TypeScript, Tailwind CSS, and pixel-perfect accuracy. Use when a user provides a Figma URL or asks to convert Figma designs to code./figma-to-reactUse when the user wants to extract Figma designs into production-ready React or Next.js components with TypeScript, Tailwind CSS, and pixel-perfect accuracy./flowguardGuard long, ambiguous, or stateful AI-agent work from drift. Use when the user asks to run or continue a multi-step task, autonomous loop, bug fix, repo change, PR readiness check, compaction handoff, resume from previous context, cost-control checkpoint, or any task likely to /frontend-designCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics./gemma4-local-deploy在本机 Mac 或 Apple Silicon 上部署 Gemma 4 12B。本地安装/升级 llama.cpp，下载 GGUF 量化模型，用 llama-server 暴露 OpenAI-compatible API，或用 Ollama 暴露本地模型服务；按用户需求在默认 Q4_K_M、64K/128K 长上下文、QAT Q4_0 @ 256K、左右对比演示之间选择，配置 tmux 后台运行，验证健康检查、问答接口、资源占用和常见故障。当用户说部署 Gemma 4、Gemma 4 /git-commit-smartGenerates meaningful, conventional commit messages automatically. Use when committing code changes. Analyzes diff to create descriptive commits following best practices./github-trendingGitHub Trending 探索与分析。用于发现热门开源项目、技术趋势、开发者偏好，帮助理解技术社区的兴趣走向。使用场景包括“看看今天 GitHub 什么火了”、“Rust 最近热门项目”、“AI 领域趋势日报”、“这个方向有没有值得关注的开源项目”、“帮我做个 GitHub trending 分析”。/golang-webModern Go Web application architecture guide. Use when creating new Go web projects, APIs, or microservices. Covers project structure, tech stack selection, and best practices based on Go standards./gpu-use查看远程服务器 GPU 使用情况。SSH 连接服务器，展示每张卡的显存占用、运行进程、所属容器。当用户说查看 GPU、显卡占用、显存使用时使用 /harmonyos-appHarmonyOS application development expert. Use when building HarmonyOS apps with ArkTS, ArkUI, Stage model, and distributed capabilities. Covers HarmonyOS NEXT (API 12+) best practices./humanizerRemove signs of AI-generated writing from text. Use when editing or /incident-slo-runbookCreate or audit SLOs, SLIs, alert rules, incident response steps, escalation paths, postmortems, operational runbooks, and customer-impact communication. Use when defining production reliability, preparing launch readiness, responding to an outage, writing a runbook, tuning /ip-check检测一个 IP 或住宅/机房代理节点的质量——注册库、地理库一致性、ASN/org、风控信誉、黑名单、住宅真实性、BGP 宣告、目标服务(Grok/Claude/ChatGPT)解锁与延迟三角测量。判定该 IP 能否安全用于 AI 服务(避免被地理库误判到别国导致区域锁)。当用户说"查这个 IP"、"这个节点在哪"、"这个代理能用吗"、"IP 质量检测"、"验收住宅 IP"、"为什么被判定在 X 国"、"check ip"、给出 socks5 代理凭证问归属或解锁时使用。/multi-ai-researchParallel multi-AI cross-validation research workflow (大版本). Dispatch N internal sub-agents + grok + gemini in parallel, automatically cross-validate findings, tier by confidence (strong consensus / partial / conflict / insufficient), generate tiered action items with /multi-model-orchestratorUse when coordinating complex tasks across multiple AI agents with a centralized handoff document for planning, execution tracking, and feedback fusion./npm-supply-chain-checkDetect known malicious npm package versions and install-time supply-chain indicators in repositories, lockfiles, and node_modules. Use when a user mentions an npm compromise, Shai-Hulud, the Keyv/cacheable incident, suspicious preinstall scripts, credential-stealing packages, or /observability-sreObservability and SRE expert. Use when setting up monitoring, logging, tracing, defining SLOs, or managing incidents. Covers Prometheus, Grafana, OpenTelemetry, and incident response best practices./optimize-networkSafely diagnose and improve local network speed, latency, jitter, DNS, Wi-Fi, Ethernet, macOS network services, and bufferbloat. Use this skill whenever the user asks to optimize internet/network speed, make the network faster, diagnose slow Wi-Fi, latency, packet loss, DNS /performance-capacityPlan, diagnose, and verify performance budgets, latency targets, load tests, capacity estimates, bottleneck analysis, caching strategy, query efficiency, queue throughput, and regression gates. Use when a feature may be slow, a system must scale, a performance regression is /playwright-automationBrowser automation and testing with Playwright. Use when testing web applications, automating browser tasks, taking screenshots, or validating UI behavior./prd-masterPRD writing and product definition expert. Use when writing PRDs, user stories, acceptance criteria, or prioritizing features. Covers RICE/MoSCoW frameworks, agile requirements, and specification best practices./product-analyticsProduct analytics and growth expert. Use when designing event tracking, defining metrics, running A/B tests, or analyzing retention. Covers AARRR framework, funnel analysis, cohort analysis, and experimentation./product-discoveryProduct discovery and market research expert. Use when validating product ideas, conducting market research, user interviews, competitive analysis, or opportunity assessment. Covers JTBD, Kano model, and Value Proposition Canvas./product-manager-toolkitUse when the user needs product management workflows such as RICE prioritization, customer interview analysis, PRD templates, discovery frameworks, go-to-market strategy, feature prioritization, research synthesis, or requirements documentation./product-ux-expertProduct interaction and UX expert. Use when reviewing UI/UX, conducting heuristic evaluations, designing user journeys, applying cognitive psychology principles, or ensuring WCAG 2.2 accessibility compliance./project-health-auditorComprehensive codebase health analysis. Use when reviewing code quality, identifying technical debt, checking dependencies, or assessing project structure./python-projectModern Python project architecture guide for 2025. Use when creating Python projects (APIs, CLI, data pipelines). Covers uv, Ruff, Pydantic, FastAPI, and async patterns./react-best-practicesReact and Next.js performance playbook distilled from Vercel Engineering guidance. Use when building, reviewing, or refactoring React/Next.js code for waterfalls, bundle size, rendering cost, and client/server data flow./react-hooks-best-practicesProvides React patterns for hooks, effects, refs, and component design. Covers escape hatches, anti-patterns, and correct effect usage. Use when reading or writing React components with hooks or effects./recap回顾最近 N 天的 Claude Code 使用记录——扫描原始会话数据，按主题分组汇总"我都做了什么"，并从个人操作系统视角输出模式、风险与增删建议。当用户说 /recap、"看看我这几天做了什么"、"回顾一下我最近的会话"、"这两天我用 claude 干了啥"、"活动回顾" 时使用。/release-engineeringPlan and verify software releases with versioning, changelogs, release branches, feature flags, canaries, migration gates, rollback, deployment checks, and release readiness. Use when preparing a release, shipping a risky PR, coordinating app/backend/database rollout, recovering /repo-agent-context-auditAudit and recommend improvements for a repository's agent-readable context, including AGENTS.md, CLAUDE.md, WARP.md, CONTRIBUTING.md, .agents/skills, and specs/ PRODUCT.md and TECH.md contracts. Use when asked to review, score, assess, or standardize repo instructions, agent /repo-scaffoldScaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs. Use when starting a new repo, turning a prototype into a maintainable project, adding missing repository /review-gateUse before an agent-produced diff is committed, pushed, opened as a PR, merged, landed, or applied to user files when explicit implementation approval is missing. Trigger for review gate, review pack, approve before landing, diff first then land, human approval, merge gate,/rust-best-practicesUse when writing, modifying, or reviewing Rust code. ALWAYS invoke before Rust edits; covers Microsoft Pragmatic Rust guidance for error handling, API design, performance, and idiomatic patterns./rust-projectModern Rust project architecture guide for 2025. Use when creating Rust projects (CLI, web services, libraries). Covers workspace structure, error handling, async patterns, and idiomatic Rust best practices./rustdesk-doctor诊断 RustDesk 连接问题。当用户说 RustDesk 连不上、无法远程、ID 不显示、注册失败时使用 /security-threat-modelThreat-model product features, APIs, data flows, secrets, permissions, supply-chain changes, auth boundaries, and risky code paths before or during implementation. Use when touching authentication, authorization, payments, secrets, user data, uploads, webhooks, admin tools,/server-security服务器安全审计与加固。扫描 SSH、防火墙、端口暴露、文件权限、暴力破解等安全问题，生成报告并提供一键修复。当用户说服务器安全、安全审计、安全检查、安全加固时使用 /skill-auditAudit, design, categorize, distribute, and measure agent skills using lessons from Anthropic's Lessons from building Claude Code: How we use skills. Use when reviewing an existing skill, deciding whether a workflow deserves a skill, planning a skill library, turning team /skill-creatorCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's /skill-ecosystem-doctorAudit and safely repair cross-runtime Skill ownership, loading, duplication, scopes, budgets, lifecycle, quarantine, and retirement. Usage statistics alone belong to skill-usage-stats. Use when explicitly governing the Skill ecosystem; ignore mentions/traces./skill-lifeguardUse when a skill is brittle, drifting, repeatedly failing, or needs a Reliable Skill Contract. Trigger for phrases like skill lifeguard, reliable skill, self-maintaining skill, negative examples, verification checkpoints, drift signals, replay hooks, or failure log to skill /skill-usage-stats只读统计 Claude/Codex 的 Skill 使用证据并检查 agent 配置健康。仅用于明确的健康检查、配置诊断、使用排行或低使用候选请求；会识别 enabled 插件并单列批量审计读取。不要用于规范源、触发、全局/项目/profile/冷存储、投影或退役治理，改用 skill-ecosystem-doctor。忽略引用日志和相邻任务。/slides生成口播视频背景 PPT 幻灯片（16:9 横版 PNG 序列）。当用户需要做 PPT、生成幻灯片、做演示背景图时使用 /sol-luna-routerRoute coding work so GPT-5.6 Sol remains the commander and reviewer while a separate GPT-5.6 Luna Codex CLI session performs concrete implementation. Use when the user asks for Sol to direct, plan, supervise, or review work done by Luna; when native Sol-to-Luna subagent spawning /structured-logging-liteDesign, audit, or implement application structured logging architecture from repository evidence. Use when a user asks whether or where to add logs, how to choose or migrate a logger, how to standardize events/fields/levels/redaction, how to add HTTP access or panic logs, or why /system-doctor系统性能诊断。当用户说电脑卡、系统慢、查看进程、CPU占用高、内存不够等性能问题时使用 /systematic-debuggingFour-phase debugging framework for any technical issue. Use when encountering bugs, errors, or unexpected behavior. Prevents random fix attempts./technical-specTechnical specification and design document expert. Use when writing design docs, RFCs, ADRs, or evaluating technology choices. Covers C4 model, system design, and architecture documentation./threadsUse when the user explicitly asks for $threads, Codex-native subagents, 开几个子 agent, or a GitHub issue/PR queue needing parallel lanes, worktrees, review/merge gates, and closure audit. Do not use for OS/language threads, chat/email/forum threads, or Assistants product threads /trip-plannerUse when the user wants detailed travel itineraries with activities, logistics, day-by-day schedules, vacation planning, trip organization, or travel documentation./typescript-projectModern TypeScript project architecture guide for 2025. Use when creating new TS projects, setting up configurations, or designing project structure. Covers tech stack selection, layered architecture, and best practices./ui-design-systemUse when creating or maintaining UI design systems, design tokens, component documentation, responsive calculations, quality checks, or design-dev handoff materials./ui-designerExtract design systems from reference UI images and generate implementation-ready UI design prompts. Use when users provide UI screenshots/mockups and want to create consistent designs, generate design systems, or build MVP UIs matching reference aesthetics./ui-ux-pro-maxUse when planning, building, designing, code review, refactor, fixing, improving, optimizing, enhancing, or checking UI/UX work. Covers product patterns, landing pages, chart choices, visual styles, palettes, typography, UX rules, and 9 stacks (React, Next.js, Vue, Svelte,/vibeguardLightweight anti-hallucination workflow for task kickoff, review prioritization, and regression retrospectives. Use when the user asks for guardrails, task contracts, risk scoring, or review templates./vscode-doctorDiagnose slow or freezing VS Code-compatible editors with evidence-first, zero-hardcoded-assumption workflow. Use when the user reports editor lag, typing delay, UI freezes, extension host stalls, file watcher noise, high editor CPU/RSS, uses VS Code/Cursor as a file browser /web-artifacts-builderUse when creating elaborate, multi-component claude.ai HTML artifacts with React, Tailwind CSS, shadcn/ui, state management, routing, or complex frontend structure; not for simple single-file HTML/JSX artifacts./web-asset-generatorGenerate web assets including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Use when users need icons, favicons, social sharing images, or Open Graph images from logos or text slogans. Handles image resizing,/xiaohongshu-netfeel-guardian当用户用 Claude 写小红书、公众号、视频脚本等内容时，输出出现翻译腔、英文思考、西式框架，导致“像外国人假装写中文”时使用。典型触发语句： - “Claude写小红书翻译腔太重”“英文思考输出灾难” - “帮我把这个笔记改成纯中文网感”“去除Claude翻译腔” - “公众号文章中途变英文了”“50 Skills内容生成翻车” - “强制Claude用中文思考写笔记”“小红书情绪化表达润色” 始终保护用户原有的 CLAUDE.md / AGENTS.md 中的人设与语气要求，只做最小必要干预。优先与 xiaohongshu 技能组合使用。/xiaohongshu生成小红书文案和配图。当用户需要写小红书、生成社交媒体文案、小红书运营内容时使用 /zig-projectModern Zig project architecture guide. Use when creating Zig projects (systems programming, CLI tools, game dev, high-performance services). Covers explicit allocators, comptime, error handling, and build system.

Agents

backend-typescript-architectSenior backend TypeScript architect specializing in Bun/Node.js runtime, API design, database optimization, and scalable server architecture.code-archaeologistExpert at exploring and understanding legacy and unfamiliar codebases. Maps dependencies, identifies patterns, and creates documentation for complex systems.kubernetes-specialistKubernetes architect specializing in cluster design, manifests, Helm charts, GitOps workflows, security policies, and production operations.opensource-contributorSystematic open source contributor that analyzes projects, finds suitable issues, implements fixes, and creates high-quality PRs with high acceptance probability.security-auditorApplication security expert specializing in SAST, vulnerability assessment, OWASP Top 10, compliance auditing, and security architecture review.senior-code-reviewerFullstack code reviewer with 15+ years experience analyzing code for security vulnerabilities, performance bottlenecks, architectural decisions, and best practices.

Show all 10 agents

tech-lead-orchestratorSenior technical lead who analyzes complex projects and coordinates multi-step development tasks. Delegates to specialized agents and ensures quality delivery.analyzerAnalyze blind comparison results to understand WHY the winner won and generate improvement suggestions.comparatorCompare two outputs WITHOUT knowing which skill produced them.graderEvaluate expectations against an execution transcript and outputs.

README

Read on GitHub

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
`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
`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:

Hard Rules - Mandatory constraints with FORBIDDEN / REQUIRED markers
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

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.

File tree

570

majiayu000/spellbookView on GitHub

.github/
  ISSUE_TEMPLATE/
    bug_report.md
    config.yml
    feature_request.md
  pull_request_template.md
  workflows/
    pages.yml
    validate.yml
.gitignore
agents/
AGENTS.md
  backend-typescript-architect.md
  code-archaeologist.md
  kubernetes-specialist.md
  opensource-contributor.md
  security-auditor.md
  senior-code-reviewer.md
  tech-lead-orchestrator.md
CHANGELOG.md
claude-md/
  .gitkeep
  rust-project.md
CODE_OF_CONDUCT.md
codex/
  adapters/
    xiaohongshu-netfeel-guardian/
      codex-adapter.md
      README.md
  README.md
CONTRIBUTING.md
docs/
  .nojekyll
  agent-reliability-trio.md
  agents-analysis.md
  assets/
    spellbook-social-preview.png
  creating-plugins.md
  index.html
  installation.md
  migration-from-claude-arsenal.md
  product-lifecycle-skills-en.md
  product-lifecycle-skills-zh.md
  runtime-targets.md
  showcase.md
  skill-designs.md
  skill-format-policy.md
  skill-layering-architecture.md
  skill-optimization-report.md
  skill-quality-playbook.md
  skill-registry.md
  skill-test-report.md
  skill-testing-guide.md
  skills-agents-analysis.md
  skills.html
  spellbook-operating-contract.md
  threads-run-governance-spec.md
hooks/
  .gitkeep
install.sh
learn/
  product-manager-responsibilities.md
  software-architect-responsibilities.md
LICENSE
plugins/
  rust-dev/
    .claude-plugin/
      plugin.json
    skills/
      rust-best-practices.SKILL.md
pytest.ini
README_CN.md
README.md
registry/
  AGENTS.md
  skills.json
  tag_overrides.yml
  tags.json
scripts/
  AGENTS.md
  audit_skill_quality.py
  runtime_compatibility.py
  skill_artifact_checks.py
  skill_dependency_checks.py
  skill_frontmatter.py
  skill_path_safety.py
  validate_skills.py
SECURITY.md
skills/
  AGENTS.md
  agentsmd-optimize/
    SKILL.md
  agentsmd-scaffold/
    evals/
      evals.json
    references/
      scaffold-agents.md
    scripts/
      scan_repo_context.py
    SKILL.md
  api-design/
    reference/
      comparison.md
      graphql.md
      grpc.md
      rest.md
    SKILL.md
    templates/
      graphql/
        schema.graphql
      grpc/
        service.proto
      openapi/
        openapi.yaml
  app-ui-design/
    reference/
      accessibility.md
      color-theory.md
      extended.md
      ios-guidelines.md
      material-design.md
    SKILL.md
    templates/
      design-system-template.md
  app-user-story-qa/
    agents/
      openai.yaml
    SKILL.md
  architecture-foundation/
    agents/
      openai.yaml
    references/
      go-architecture-patterns.md
      rust-architecture-patterns.md
      spec-template.md
    SKILL.md
  ask-opencli/
    SKILL.md
  auth-security/
    reference/
      attacks.md
      jwt.md
      oauth2.1.md
    SKILL.md
    templates/
      typescript/
        auth.service.ts
  brainstorming.SKILL.md
  capability-distill/
    evals/
      evals.json
      files/
        incident_existing_skills.md
        incident_timeline.md
        review_judgment_packet_v1.md
        review_trajectory.md
    SKILL.md
  clash-doctor/
    references/
      full-guide.md
    SKILL.md
  clash-routes/
    SKILL.md
  claude-code-reverse/
    extract.sh
    references/
      claude-code.md
    SKILL.md
    tests/
      test_extract.sh
  cliproxy-newapi-stack/
    agents/
      openai.yaml
    references/
      multi-account.md
      newapi-pricing.md
      troubleshooting.md
    scripts/
      add_codex_account.sh
      deploy_newapi.sh
      lib/
        validation.sh
      set_pricing.py
      test_security_validation.sh
      topup.sh
      verify_stack.sh
    SKILL.md
  codebase-audit/
    evals/
      evals.json
      expected-findings.json
      fixture/
        app/
          __init__.py
          config.py
          handlers.py
          main.py
          pipeline.py
          registry.py
          storage.py
          tasks.py
        config.yaml
        README.md
        requirements.txt
        tests/
          test_pipeline.py
      README.md
    references/
      agent-prompts.md
      ledger-format.md
      stack-patterns.md
      workflow-template.md
    SKILL.md
  codex/
  codex-agent/
    advanced.md
    examples.md
    README.md
    sandbox-modes.md
    scripts/
      check-codex.sh
      codex-wrapper.sh
    SKILL.md
  codex-fluent/
    references/
      examples/
        handoff-quality-example.md
        typical-before-after.md
      handoff-template.md
      maintenance-checklist.md
    SKILL.md
  codex-log-guard/
    agents/
      openai.yaml
    SKILL.md
  codex-retrospective/
    references/
      agents-md-update-rules.md
      examples/
        good-retrospective-output.md
      minimal-skill-criteria.md
      retrospective-prompt.md
    SKILL.md
    README.md
    SKILL.md
  comprehensive-testing/
    reference/
      extended.md
    SKILL.md
  config-secrets-environments/
    agents/
      openai.yaml
    SKILL.md
  contribution-architect/
    SKILL.md
  contributor/
    SKILL.md
  css-debug/
    SKILL.md
  data-contract-migrations/
    agents/
      openai.yaml
    SKILL.md
  database-patterns/
    reference/
      caching.md
      postgresql.md
      redis.md
    SKILL.md
  dev-architecture-playbook/
    agents/
      openai.yaml
    SKILL.md
  devops-excellence/
    reference/
      cicd.md
      containers.md
      extended.md
      release-strategies.md
    SKILL.md
    templates/
      Dockerfile
      github-actions.yaml
  disk-cleaner/
    SKILL.md
  elegant-architecture/
    SKILL.md
  figma-to-code/
    reference/
      extended.md
    SKILL.md
  figma-to-react/
    reference/
      extended.md
    SKILL.md
  flowguard/
    agents/
      openai.yaml
    references/
      state-contract.md
    scripts/
      workflow_state_snapshot.sh
    SKILL.md
  frontend-design/
    SKILL.md
  gemma4-local-deploy/
    agents/
      openai.yaml
    references/
      llama-cpp.md
      ollama.md
      verification.md
    SKILL.md
  git-commit-smart/
    SKILL.md
  github-trending/
    reference/
      extended.md
    requirements.txt
    scripts/
      fetch_trending.py
    SKILL.md
  golang-web/
    reference/
      architecture.md
      patterns.md
      tech-stack.md
    SKILL.md
    templates/
      project/
        cmd/
          myapp/
            main.go
        config.yaml
        configs/
          config.go
        go.mod
        internal/
          handlers/
            user.go
          models/
            user.go
          repositories/
            user.go
          router/
            router.go
          services/
            user.go
        Makefile
        pkg/
          database/
            database.go
          errors/
            errors.go
          response/
            response.go
          server/
            server.go
  gpu-use/
    SKILL.md
  harmonyos-app/
    reference/
      arkts.md
      arkui.md
      distributed.md
      extended.md
      stage-model.md
    SKILL.md
    templates/
      project-template.md
  humanizer/
    README.md
    references/
      full-guide.md
    SKILL.md
    WARP.md
  incident-slo-runbook/
    agents/
      openai.yaml
    SKILL.md
  ip-check/
    scripts/
      ipcheck.py
    SKILL.md
  multi-ai-research/
    reference/
      extended.md
    SKILL.md
  multi-model-orchestrator/
    LICENSE
    README.md
    references/
      add-auth-to-api.yaml
      advanced-sync.md
      best-practices.md
      faq.md
      handoff-structure.md
      quick-start.md
      workflow-patterns.md
    SKILL.md
... 467 more

FAQ

spellbook is a Claude Code plugin with 93 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes agentsmd-optimize, agentsmd-scaffold, api-design. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is spellbook?: Cross-runtime skills for Claude Code, Codex, and multi-agent workflows.
How do I install spellbook?: Run these in Claude Code: npx -y skills add majiayu000/spellbook --agent claude-code. Then prompt normally.
Does spellbook auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is spellbook free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.