majiayu000 /spellbook
Cross-runtime skills for Claude Code, Codex, and multi-agent workflows.
★ 299⑂ 33👁 2⑃ 144● 87▤ 1
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-27First 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.