majiayu000 /spellbook

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

★ 299⑂ 33👁 2⑃ 144● 87▤ 1
PythonMITCreated 2025-12-09majiayu000.github.io/spellbook/
下载:v0.1.0v0.1.0 ↓0.1.02026-09-27
299
stars
33
forks
2
watchers
144
prs
87
issues
1
releases

README

Spellbook
  121 个跨 Runtime Skills | 7 个 Claude Code Agents | 一键安装

  面向 Claude Code、Codex 与多智能体工作流的跨 Runtime 技能库。

  
    
    
    
    
  

  
    快速开始 •
    Runtime 目标 •
    选择工作流 •
    技能列表 •
    智能体 •
    更新日志 •
    发布状态 •
    贡献 •
    English
  


---

 改名说明: Spellbook 原名 Claude Arsenal。Claude Code 仍是一等支持目标;新名称是为了覆盖 Claude Code、Codex 与跨 Runtime agent skills 的长期路线。详情见迁移说明。

---

 快速开始

先从一个贴近任务的工作流开始。维护中的 skills CLI 会在安装时让你选择
支持的 coding agents,并且只安装下面四个技能:

bash
npx skills add majiayu000/spellbook --skill frontend-design --skill app-ui-design --skill ui-design-system --skill figma-to-react


安装前可以运行 npx skills add majiayu000/spellbook --list 查看目录。
另外四个起步组合见选择工作流。

 高级跨 Runtime 安装器

当你需要明确指定 Claude Code/Codex 的安装路径,或同时安装仓库里的
Claude Code agents 时,继续使用 install.sh。

bash
 将全部技能和支持的 agents 安装到两个维护中的 runtime
curl -fsSL https://raw.githubusercontent.com/majiayu000/spellbook/main/install.sh | bash -s -- --target all

 或克隆仓库并明确选择技能
git clone https://github.com/majiayu000/spellbook.git
cd spellbook
./install.sh --target all --skills typescript-project,python-project,devops-excellence


 验证安装

- Claude Code:输入 / 查看已安装的技能。
- Codex:重启 Codex,让它重新加载 ~/.agents/skills。

---

 Runtime 目标

Spellbook 将 skill 源文件保存在一个地方,再安装到你实际使用的 runtime。

| 目标 | 安装位置 | 状态 |
|------|----------|------|
| Claude Code | ~/.claude/skills 和 ~/.claude/agents | 支持 skills 和 agents |
| Codex | ~/.agents/skills | 支持 skills;跳过 agents |
| all | 同时安装到 Claude Code 和 Codex 路径 | 推荐给多工具用户 |

Claude Code 仍是一等支持目标,也是用户搜索和认知入口。项目原名 Claude Arsenal;改名为 Spellbook 是为了表达更长期的目标:让可复用 skills 在不同 coding agents 之间流动。
旧版 Spellbook 曾将 Codex skills 安装到 ~/.codex/skills;请重新运行当前安装器,以使用 Codex 文档中的用户级 skill 路径。

---

 在 Claude Code 中使用 .agents/skills

2026 年 10 月 7 日核对:官方指令文档说明,Claude Code 从 v2.1.277 起支持直接读取 AGENTS.md。默认条件是当前目录及其祖先目录中没有 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md。可以在 Project instructions 设置中选择同时加载两种文件。无法直接加载时,在相邻的 CLAUDE.md 中写入 @AGENTS.md。

Skills 使用另一套发现路径:官方列出的目录包含 .claude/skills 和 ~/.claude/skills,没有 .agents/skills。如果仓库已经把 skills 放在 .agents/skills,可以在仓库根目录执行下面的命令,前提是 .claude/skills 尚不存在,也不是已有软链接:

bash
mkdir -p .claude
ln -s ../.agents/skills .claude/skills


两个路径会指向同一个目录,修改会同时影响两种工具,因此不能在其中加入仅供 Claude 使用的 skill。如果已有 .claude/skills,保留它,只链接需要共享的 skill(将 my-skill 替换为已有 skill 的目录名):

bash
ln -s ../../.agents/skills/my-skill .claude/skills/my-skill


官方 skills 文档支持单个 skill 目录的软链接。本机 macOS 上,Claude Code 2.1.234 的 CLI 初始化事件在两种链接布局下都列出了测试 skill;不建链接时,同一命令显示 unknown。该安装未登录,模型执行尚未验证。重启 Claude Code,在 / 列表中确认 skill,再调用一次,以验证自己的环境。

Windows 的目录软链接使用 mklink /D,创建软链接可能需要 Developer Mode 或管理员权限;Git 的 core.symlinks 设置也会影响检出。这里没有验证 Windows 加载,团队可以使用分别安装到目标目录的方式:

bash
 在 Spellbook checkout 中运行,将所选 skills 安装到用户级目录
./install.sh --target all --skills typescript-project,python-project

 或使用 skills CLI,在提示中选择 Claude Code 和 Codex
npx skills add majiayu000/spellbook --skill typescript-project


安装器会在 ~/.claude/skills 与 ~/.agents/skills 创建指向共享源码 checkout 的条目,不会同步任意项目目录。以上说明针对本地 Claude Code CLI;其他会话类型可能使用不同的加载规则。

---

Latest release

v0.1.0 v0.1.0 2026-09-27
First numbered Spellbook release. This tag snapshots main. The install path remains the main branch.

 Changed

- Expanded clash-doctor and clash-routes with local-hub ownership, request-level Mihomo endpoint fallback, and read-only multi-machine checks without publishing personal network inventory.
- Tightened the threads skill so GitHub queue and merge-capable runs default to durable local JSONL evidence, report active skill source, require connector and review-thread completion before merge, and prefer writable contributor PRs over replacement PRs.

Snapshot: 2026-11-17T21:58:29Z · Data license Apache-2.0 · JSON