spellbook
Cross-runtime skill library and Claude Code plugins: product coaching, development toolkits, and workflow skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/majiayu000/spellbook with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/majiayu000/spellbook'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/majiayu000--spellbook)HTML
<a href="/listings/majiayu000--spellbook"><img src="/api/listings/majiayu000--spellbook/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
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](#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`.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 30 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "spellbook",
- "description": "Cross-runtime skill library and Claude Code plugins: product coaching, development toolkits, and workflow skills",
- "strict": true,
- "owner": {
- "name": "majiayu000",
- "url": "https://github.com/majiayu000"
- },
- "plugins": [
- {
- "name": "idea-coach",
- "description": "Idea coaching toolkit: an opinionated end-to-end product coach (idea -> PRD -> clickable HTML prototype) plus a multi-role idea group chat for blind-spot discovery",
- "author": {
- "name": "majiayu000"
- },
- "category": "product",
- "source": "./plugins/idea-coach"
- },
- {
- "name": "rust-dev",
- "description": "Rust development toolkit with best practices, code review, performance optimization, and async Rust patterns",
- "author": {
- "name": "majiayu000"
- },
- "category": "development",
- "source": "./plugins/rust-dev"
- }
- ]
- }
README.md · README · 493 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <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](./docs/migration-from-claude-arsenal.md) 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:
- ```bash
- 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](#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.
- ```bash
- # 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](https://code.claude.com/docs/en/memory#agentsmd) 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](https://code.claude.com/docs/en/skills#choose-where-skills-load) 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:
- ```bash
- 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):
- ```bash
- 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`](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/mklink), 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:
- ```bash
- # 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](./docs/showcase.md) for copy-paste prompts and expected outputs.
- Use the [Spellbook Skill Browser](https://majiayu000.github.io/spellbook/skills.html)
- for curated first-party skills, or the
- [Claude Skills Registry](https://majiayu000.github.io/claude-skill-registry/)
- for broader community discovery.
- Release history lives in [Changelog](./CHANGELOG.md).
- ---
- ## 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](./docs/skill-registry.md).
- > Skill layout rules live in [Skill Format Policy](./docs/skill-format-policy.md).
- > Skill authoring quality rules live in [Skill Quality Playbook](./docs/skill-quality-playbook.md).
- ### Search the Registry
- ```bash
- # 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`](./registry/tags.json) for tooling and dashboards. Curated overrides for skills the keyword heuristic cannot infer live in [`registry/tag_overrides.yml`](./registry/tag_overrides.yml).
- Audit non-blocking skill quality signals:
- ```bash
- 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`](./skills/multi-model-orchestrator/) | Coordinate multi-agent tasks via a centralized handoff document |
- | [`flowguard`](./skills/flowguard/) | Guard long, ambiguous, or stateful agent tasks from drift |
- | [`skill-lifeguard`](./skills/skill-lifeguard/) | Add reliable-skill contracts, checkpoints, smoke hooks, and drift signals |
- | [`review-gate`](./skills/review-gate/) | Produce review packs and require human approval before landing agent changes |
- | [`skill-audit`](./skills/skill-audit/) | Audit, design, categorize, and measure agent skills |
- | [`skill-checkup`](./skills/skill-checkup/) | Find broken, drifted, competing and one-sided skills across Claude Code and Codex |
- | [`skill-ecosystem-doctor`](./skills/skill-ecosystem-doctor/) | Govern canonical sources, projections, retirement, quarantine, and cross-runtime verification |
- | [`threads`](./skills/threads/) | Codex-native subagents and parallel GitHub queue lanes |
- | [`codex-fluent`](./skills/codex-fluent/) | Codex session hygiene, archive strategy, and handoff discipline |
- | [`codex-retrospective`](./skills/codex-retrospective/) | Codex self-review of recent history to improve behavior |
- | [`model-inference-optimize`](./skills/model-inference-optimize/) | Profile and optimize model inference with quality and cost checks, using anonymized cases |
- | [`brainstorming`](./skills/brainstorming.SKILL.md) | Socratic dialogue for design refinement and architecture exploration |
- See [`docs/agent-reliability-trio.md`](./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`](./skills/typescript-project/) | TypeScript | ESM, Zod, Biome, Clean Architecture |
- | [`python-project`](./skills/python-project/) | Python | uv, Pydantic, Ruff, FastAPI |
- | [`rust-project`](./skills/rust-project/) | Rust | Cargo workspace, error handling, async |
- | [`golang-web`](./skills/golang-web/) | Go | Chi/Echo, sqlc, structured logging |
- | [`zig-project`](./skills/zig-project/) | Zig | Build system, memory management |
- | [`architecture-foundation`](./skills/architecture-foundation/) | Cross-language | Runtime, state ownership, adapters, and convergence specs |
- | [`elegant-architecture`](./skills/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`](./skills/product-discovery/) | Discovery | JTBD, user interviews, market research |
- | [`prd-master`](./skills/prd-master/) | Definition | PRD writing, user stories, RICE prioritization |
- | [`technical-spec`](./skills/technical-spec/) | Design | Design docs, ADR, C4 diagrams |
- | [`product-analytics`](./skills/product-analytics/) | Growth | Event tracking, A/B testing, AARRR |
- | [`devops-excellence`](./skills/devops-excellence/) | Deployment | CI/CD, Docker, Kubernetes, GitOps |
- | [`observability-sre`](./skills/observability-sre/) | Operations | Monitoring, logging, tracing, SLO/SLI |
- | [`product-manager-toolkit`](./skills/product-manager-toolkit/) | Definition | RICE, customer interviews, PRD templates, discovery frameworks |
- ### API & Backend
- | Skill | Description |
- |-------|-------------|
- | [`api-design`](./skills/api-design/) | REST/GraphQL/gRPC patterns, OpenAPI 3.2 |
- | [`auth-security`](./skills/auth-security/) | OAuth 2.1, JWT, security best practices |
- | [`database-patterns`](./skills/database-patterns/) | PostgreSQL, Redis, migrations, optimization |
- | [`codebase-audit`](./skills/codebase-audit/) | Deep adaptive repository audit with severity-ranked findings and repair roadmap |
- | [`structured-logging-lite`](./skills/structured-logging-lite/) | Centralized logging, field standards, and distributed tracing |
- ### Development Practices
- | Skill | Description | Origin |
- |-------|-------------|--------|
- | [`contributor`](./skills/contributor/) | End-to-end open source contribution workflow from issue discovery to PR submission | Custom |
- | [`repo-agent-context-audit`](./skills/repo-agent-context-audit/) | Audit and scaffold repo agent context across AGENTS, skills, and specs | Custom |
- | [`skill-creator`](./skills/skill-creator/) | Create, improve, and benchmark reusable skills | Custom |
- | [`humanizer`](./skills/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`](./skills/agent-qa-testing/) | Web/mobile regression runs and triage with advanced memidex memory and self-improvement |
- | [`app-user-story-qa`](./skills/app-user-story-qa/) | End-to-end app feature inventory, canonical tracker, user-story testing, fixes, and retest loop |
- | [`test-driven-development`](./skills/test-driven-development.SKILL.md) | Enforce RED-GREEN-REFACTOR TDD discipline |
- | [`comprehensive-testing`](./skills/comprehensive-testing/) | Test pyramid, unit/integration/E2E/property testing, framework best practices |
- | [`git-commit-smart`](./skills/git-commit-smart/) | Generate meaningful conventional commit messages from diff |
- | [`push-all`](./skills/push-all.SKILL.md) | Stage, commit, and push all changes after safety checks |
- | [`project-health-auditor`](./skills/project-health-auditor/) | Codebase health, tech debt, dependency, and project risk analysis |
- | [`loop-close`](./skills/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`](./skills/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`](./skills/codex/) | Invoke Codex CLI sessions from another agent workflow |
- | [`codex-agent`](./skills/codex-agent/) | Optional second-opinion review, cross-verification, and alternatives through Codex CLI |
- | [`sol-luna-router`](./skills/sol-luna-router/) | Keep GPT-5.6 Sol as commander/reviewer while GPT-5.6 Luna performs bounded implementation |
- | [`ask-opencli`](./skills/ask-opencli/) | Ask Grok or Gemini through opencli and an existing browser session |
- | [`multi-ai-research`](./skills/multi-ai-research/) | Parallel research across multiple AI tools and internal agents |
- ### UI/UX & Design
- | Skill | Description |
- |-------|-------------|
- | [`app-ui-design`](./skills/app-ui-design/) | iOS/Android UI design, Material Design 3, HIG |
- | [`product-ux-expert`](./skills/product-ux-expert/) | UX evaluation, heuristics, accessibility |
- | [`frontend-design`](./skills/frontend-design/) | Web frontend design patterns |
- | [`illustrated-gallery`](./skills/illustrated-gallery/) | Illustrated website template with full-frame ASCII transitions |
- | [`ascii-backdrop`](./skills/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`](./skills/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`](./skills/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`](./skills/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`](./skills/ui-designer/) | Extract design systems from UI screenshots and references |
- | [`ui-design-system`](./skills/ui-design-system/) | Design system toolkit and design-dev handoff support |
- | [`web-artifacts-builder`](./skills/web-artifacts-builder/) | Claude.ai HTML artifacts |
- | [`react-best-practices`](./skills/react-best-practices/) | React and Next.js performance patterns distilled from Vercel guidance |
- | [`react-hooks-best-practices`](./skills/react-hooks-best-practices/) | React hooks, effects, refs, and component design patterns |
- | [`blender-editable-3d`](./skills/blender-editable-3d/) | Editable Blender models from references or concepts, with part-level edits and verified exports |
- | [`blender-reference-to-3d`](./skills/blender-reference-to-3d/) | Reference analysis, Blender character modeling, color, multiview review, and editable delivery |
- | [`slides`](./skills/slides/) | Speech-friendly slide deck and background slide generation |
- | [`ui-ux-pro-max`](./skills/ui-ux-pro-max/) | Compact UI/UX tables for product patterns, landing pages, charts, and 9 stacks |
- | [`figma-to-code`](./skills/figma-to-code/) | Figma designs to production React/Next.js with TypeScript and Tailwind |
- | [`css-debug`](./skills/css-debug/) | Diagnose CSS/layout issues, Tailwind conflicts, z-index stacking |
- | [`playwright-automation`](./skills/playwright-automation/) | Browser automation and testing with Playwright |
- ### Tooling & Automation
- | Skill | Description |
- |-------|-------------|
- | [`web-asset-generator`](./skills/web-asset-generator/) | Favicons, app icons, OG images |
- | [`github-trending`](./skills/github-trending/) | GitHub trending analysis |
- | [`vibeguard`](./skills/vibeguard/) | Task contracts, finding scoring, and lightweight anti-hallucination reviews |
- | [`clash-doctor`](./skills/clash-doctor/) | Clash proxy & network diagnostics |
- | [`clash-routes`](./skills/clash-routes/) | Inspect active proxy routes for specific processes via Mihomo API |
- | [`optimize-network`](./skills/optimize-network/) | Safe local network speed, latency, DNS, Wi-Fi, and bufferbloat diagnostics with VPN/proxy guardrails |
- | [`disk-cleaner`](./skills/disk-cleaner/) | Scan and reclaim disk space with interactive cleanup guidance |
- | [`system-doctor`](./skills/system-doctor/) | Diagnose CPU, memory, and process-level system slowdowns |
- | [`codex-log-guard`](./skills/codex-log-guard/) | Diagnose and mitigate excessive Codex local SQLite diagnostic log writes |
- | [`server-security`](./skills/server-security/) | Audit and harden Linux server SSH, firewall, and exposed services |
- | [`cliproxy-newapi-stack`](./skills/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`](./skills/gemma4-local-deploy/) | Deploy Gemma 4 12B locally on Mac/Apple Silicon via llama.cpp or Ollama |
- | [`gpu-use`](./skills/gpu-use/) | Inspect remote server GPU usage (per-card VRAM, processes, containers) |
- | [`rustdesk-doctor`](./skills/rustdesk-doctor/) | Diagnose RustDesk connection issues |
- | [`vscode-doctor`](./skills/vscode-doctor/) | Diagnose slow or freezing VS Code-compatible editors |
- ### Content & Social Media
- | Skill | Description |
- |-------|-------------|
- | [`xiaohongshu`](./skills/xiaohongshu/) | Xiaohongshu content creation & publishing |
- | [`trip-planner`](./skills/trip-planner/) | Travel itinerary planning |
- | [`avoidance-coach`](./skills/avoidance-coach/) | Self-help coach for breaking avoidance loops (CBT/DBT/ACT, not therapy) |
- | [`code-film`](./skills/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`](./skills/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`](./skills/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`](./skills/weekly.SKILL.md) | Weekly report from Git, Claude Code, and Codex sessions |
- | [`xiaohongshu-netfeel-guardian`](./skills/xiaohongshu-netfeel-guardian/) | Remove translation-tone from Claude's Chinese content for native readability |
- ### Mobile & Cross-Platform
- | Skill | Description |
- |-------|-------------|
- | [`harmonyos-app`](./skills/harmonyos-app/) | HarmonyOS with ArkTS, ArkUI, Stage Model |
- ### Rust Specific
- | Skill | Description |
- |-------|-------------|
- | [`rust-best-practices`](./skills/rust-best-practices/) | Microsoft Rust guidelines, error handling |
- ---
- ## Agents
- Specialized agents for complex tasks.
- | Agent | Expertise | Use Case |
- |-------|-----------|----------|
- | [`tech-lead-orchestrator`](./agents/tech-lead-orchestrator.md) | Coordination | Multi-step tasks, delegation |
- | [`code-archaeologist`](./agents/code-archaeologist.md) | Exploration | Legacy codebase documentation |
- | [`backend-typescript-architect`](./agents/backend-typescript-architect.md) | Architecture | Bun/Node.js, API design |
- | [`senior-code-reviewer`](./agents/senior-code-reviewer.md) | Review | Security, performance, architecture |
- | [`kubernetes-specialist`](./agents/kubernetes-specialist.md) | Infrastructure | K8s, Helm, GitOps |
- | [`security-auditor`](./agents/security-auditor.md) | Security | OWASP Top 10, SAST |
- | [`opensource-contributor`](./agents/opensource-contributor.md) | 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`](./plugins/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`](./plugins/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](./CHANGELOG.md) | Release history and current release status |
- | [Installation Guide](./docs/installation.md) | Detailed setup instructions |
- | [Runtime Targets](./docs/runtime-targets.md) | Claude Code and Codex installation targets |
- | [Showcase](./docs/showcase.md) | Copy-paste workflow demos |
- | [Spellbook Operating Contract](./docs/spellbook-operating-contract.md) | Agent behavior rules for autonomy, escalation, pushback, feedback loops, and done-when checks |
- | [Skill Format Policy](./docs/skill-format-policy.md) | Directory vs file skill layout rules |
- | [Skill Quality Playbook](./docs/skill-quality-playbook.md) | Trigger descriptions, gotchas, progressive disclosure, and verification |
- | [Skill Testing Guide](./docs/skill-testing-guide.md) | How to validate skills work |
- | [Creating Plugins](./docs/creating-plugins.md) | Build your own skills |
- | [Product Lifecycle (EN)](./docs/product-lifecycle-skills-en.md) | Full lifecycle coverage |
- | [Product Lifecycle (中文)](./docs/product-lifecycle-skills-zh.md) | 产品生命周期覆盖 |
- ---
- ## Release Status
- Spellbook is in pre-1.0 release-readiness mode. The first numbered tag is
- [v0.1.0](https://github.com/majiayu000/spellbook/releases/tag/v0.1.0). The
- install path remains the repository `main` branch.
- See [Changelog](./CHANGELOG.md) 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](https://github.com/majiayu000/spellbook/issues/new/choose)
- - Feature ideas: [open a feature request](https://github.com/majiayu000/spellbook/issues/new/choose)
- - Security vulnerabilities: follow [Security Policy](./SECURITY.md)
- ---
- ## Credits
- Built on the shoulders of giants:
- - [anthropics/skills](https://github.com/anthropics/skills) - Official Anthropic skills
- - [obra/superpowers](https://github.com/obra/superpowers) - Development methodology
- - [claude-code-plugins-plus](https://github.com/jeremylongshore/claude-code-plugins-plus) - Plugin hub
- - [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) - Agent collection
- ---
- ## Contributing
- Contributions welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) first.
- - Found a bug? [Open an issue](https://github.com/majiayu000/spellbook/issues)
- - Have a skill idea? [Open a feature request](https://github.com/majiayu000/spellbook/issues/new/choose)
- - Want to contribute? [Submit a PR](https://github.com/majiayu000/spellbook/pulls)
- ---
- ## 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](https://github.com/majiayu000/claude-skill-registry) | Discover and search community Claude Code skills |
- | Extend | [spellbook](https://github.com/majiayu000/spellbook) **◀ you are here** | Cross-runtime skills for Claude Code, Codex, and multi-agent workflows |
- | Trust | [argus](https://github.com/majiayu000/argus) | Static install-time scanner for supply-chain attacks (npm / PyPI / crates.io) |
- | Trust | [vibeguard](https://github.com/majiayu000/vibeguard) | Rules, hooks, and guards against hallucinated or unverified agent changes |
- | Remember | [remem](https://github.com/majiayu000/remem) | Local-first persistent memory for Claude Code and Codex sessions |
- | Orchestrate | [harness](https://github.com/majiayu000/harness) | Rust agent orchestration platform — rules, skills, GC, observability |
- | Route | [litellm-rs](https://github.com/majiayu000/litellm-rs) | High-performance Rust AI gateway — 100+ LLM APIs via OpenAI format |
- | Keep | [fibo](https://github.com/majiayu000/fibo) | Session command center — monitor, recover, never lose agent work |
- ---
- ## License
- [MIT License](./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>
skills/cliproxy-newapi-stack/scripts/verify_stack.sh · Bundled script · 141 lines · 1 finding marked
- #!/usr/bin/env bash
- # Verify CLIProxyAPI through loopback, NewAPI through HTTPS, and exact billing.
- #
- # Usage:
- # SSH_TARGET=root@1.2.3.4 SSH_KEY=~/.ssh/id_ed25519 \
- # CLIPROXY_URL=http://127.0.0.1:8317 NEWAPI_URL=https://api.example.com \
- # CLIPROXY_KEY=cpa_xxx NEWAPI_TOKEN=sk-xxx MODEL=gpt-5.4 \
- # INPUT_USD_PER_M=2.5 OUTPUT_USD_PER_M=15 QUOTA_PER_UNIT=500000 \
- # ./verify_stack.sh
- set -euo pipefail
- SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
- # shellcheck source=skills/cliproxy-newapi-stack/scripts/lib/validation.sh
- . "$SCRIPT_DIR/lib/validation.sh"
- : "${SSH_TARGET:?SSH_TARGET required}"
- : "${SSH_KEY:=$HOME/.ssh/id_ed25519}"
- Note: Reads a credential file in a script that also sends data over the network
- Line 18 on GitHub
- : "${CLIPROXY_URL:=http://127.0.0.1:8317}"
- : "${NEWAPI_URL:?NEWAPI_URL required and must use HTTPS}"
- : "${CLIPROXY_KEY:?CLIPROXY_KEY required}"
- : "${NEWAPI_TOKEN:?NEWAPI_TOKEN required}"
- : "${MODEL:?MODEL required}"
- : "${INPUT_USD_PER_M:?INPUT_USD_PER_M required}"
- : "${OUTPUT_USD_PER_M:?OUTPUT_USD_PER_M required}"
- : "${QUOTA_PER_UNIT:=500000}"
- : "${MAX_QUOTA_ERROR_RATIO:=0.05}"
- : "${DB:=/root/newapi/data/one-api.db}"
- require_safe_ssh_target SSH_TARGET "$SSH_TARGET"
- require_loopback_http_origin CLIPROXY_URL "$CLIPROXY_URL"
- require_https_origin NEWAPI_URL "$NEWAPI_URL"
- require_safe_token CLIPROXY_KEY "$CLIPROXY_KEY"
- require_safe_token NEWAPI_TOKEN "$NEWAPI_TOKEN"
- require_safe_model_name MODEL "$MODEL"
- require_positive_decimal INPUT_USD_PER_M "$INPUT_USD_PER_M"
- require_positive_decimal OUTPUT_USD_PER_M "$OUTPUT_USD_PER_M"
- require_positive_uint QUOTA_PER_UNIT "$QUOTA_PER_UNIT"
- require_positive_decimal MAX_QUOTA_ERROR_RATIO "$MAX_QUOTA_ERROR_RATIO"
- require_absolute_safe_path DB "$DB"
- tmp_dir="$(mktemp -d)"
- chmod 700 "$tmp_dir"
- trap 'rm -rf "$tmp_dir"' EXIT
- nonce="$(date +%s)-$$"
- payload='{"model":"'"$MODEL"'","messages":[{"role":"user","content":"billing probe '"$nonce"'; reply OK"}],"stream":false,"max_tokens":4}'
- probe() {
- local base_url=$1 token=$2 output=$3 config=$4
- umask 077
- {
- printf 'silent\nshow-error\n'
- printf 'output = "%s"\n' "$output"
- printf 'write-out = "%%{http_code}"\n'
- printf 'request = "POST"\n'
- printf 'url = "%s/v1/chat/completions"\n' "$base_url"
- printf 'header = "Authorization: Bearer %s"\n' "$token"
- printf 'header = "Content-Type: application/json"\n'
- } > "$config"
- curl --config "$config" --data-binary @- <<< "$payload"
- rm -f "$config"
- }
- echo "[1/3] Direct CLIProxyAPI through loopback tunnel"
- http_a="$(probe "$CLIPROXY_URL" "$CLIPROXY_KEY" "$tmp_dir/cpa.json" "$tmp_dir/cpa.curl")"
- echo " HTTP $http_a"
- [ "$http_a" = "200" ] || {
- echo "FAIL direct CLIProxyAPI"
- cat "$tmp_dir/cpa.json"
- exit 1
- }
- echo "[2/3] Via NewAPI HTTPS"
- http_b="$(probe "$NEWAPI_URL" "$NEWAPI_TOKEN" "$tmp_dir/newapi.json" "$tmp_dir/newapi.curl")"
- echo " HTTP $http_b"
- [ "$http_b" = "200" ] || {
- echo "FAIL via NewAPI"
- cat "$tmp_dir/newapi.json"
- exit 1
- }
- request_id="$(python3 -c 'import json,sys; print(json.load(open(sys.argv[1], encoding="utf-8")).get("id", ""))' "$tmp_dir/newapi.json")"
- require_safe_token request_id "$request_id"
- echo "[3/3] Verify matching NewAPI billing log"
- ssh -i "$SSH_KEY" -- "$SSH_TARGET" python3 - \
- "$DB" "$request_id" "$MODEL" "$INPUT_USD_PER_M" "$OUTPUT_USD_PER_M" \
- "$QUOTA_PER_UNIT" "$MAX_QUOTA_ERROR_RATIO" <<'PY'
- from decimal import Decimal
- import sqlite3
- import sys
- (
- db_path,
- request_id,
- expected_model,
- input_usd_per_m,
- output_usd_per_m,
- quota_per_unit,
- max_error_ratio,
- ) = sys.argv[1:]
- connection = sqlite3.connect(f"file:{db_path}?mode=ro", uri=True)
- try:
- row = connection.execute(
- "SELECT model_name, prompt_tokens, completion_tokens, quota "
- "FROM logs WHERE request_id = ? ORDER BY id DESC LIMIT 1",
- (request_id,),
- ).fetchone()
- finally:
- connection.close()
- if row is None:
- raise RuntimeError("matching billing log not found")
- model_name, prompt_tokens, completion_tokens, quota = row
- if model_name != expected_model:
- raise RuntimeError(
- f"billing log model mismatch: expected {expected_model!r}, got {model_name!r}"
- )
- if prompt_tokens is None or completion_tokens is None or quota is None:
- raise RuntimeError(f"billing log has null accounting fields: {row!r}")
- error_ratio = Decimal(max_error_ratio)
- if error_ratio > Decimal(1):
- raise RuntimeError("MAX_QUOTA_ERROR_RATIO must not exceed 1")
- expected_quota = (
- Decimal(prompt_tokens) * Decimal(input_usd_per_m)
- + Decimal(completion_tokens) * Decimal(output_usd_per_m)
- ) * Decimal(quota_per_unit) / Decimal(1_000_000)
- actual_quota = Decimal(quota)
- allowed_error = max(Decimal(1), expected_quota * error_ratio)
- if abs(actual_quota - expected_quota) > allowed_error:
- raise RuntimeError(
- "billing quota mismatch: "
- f"expected {expected_quota}, got {actual_quota}, tolerance {allowed_error}"
- )
- print("model_name\tprompt_tokens\tcompletion_tokens\tquota")
- print("\t".join(map(str, row)))
- PY
- echo "OK both paths returned 200 and the matching billing quota is within tolerance"
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.