| name | skills-bulk-installer-zh |
| description | 当用户想在新机器上一次性还原所有归档 skill、清空 ~/.claude/skills/ 后批量恢复、或把 claude_workspace/workflow_skills/ 中新加的 skill 同步到 ~/.claude/skills/ 时使用。触发信号 —— "把我的 skill 全装上"、"一键安装所有 skill"、"在这台机器上配 skill"、"恢复 skill",或者用户指向一个 workflow_skills/ 归档让你全部安装。**不要**用于只装单个 skill(用户直接 cp 那个目录更快)。 |
skills-bulk-installer-zh
一次性把整个 workflow_skills/ 归档安装到 ~/.claude/skills/。同时遍历 custom/ 和 third_party/,每个 skill 都落到位;遇到必须用 Claude Code 斜杠命令(插件市场)才能装的,会在最后打印命令清单让用户粘贴。
为什么要有它
claude_workspace/workflow_skills/ 是 skill 的源仓库:custom/ 是自己写的,third_party/ 要么整目录拷贝,要么带 INSTALL.md / README.md 写明安装方法。手动一个一个装太慢且容易漏 —— 这个 skill 把整个流程脚本化。
何时用
- 新机器 / 干净环境 —— 从零拉起
~/.claude/skills/
~/.claude/ 被清掉或者容器重建后
- 别人往
workflow_skills/ 里加了新 skill,用户要拉到本地
如果只想装一个具体的 skill,别用这个 —— cp -r workflow_skills/custom/<name> ~/.claude/skills/ 更直接。
安装器如何分类
| 源目录形态 | 动作 |
|---|
custom/<name>/ | cp -r 到 ~/.claude/skills/<name>/ |
third_party/<name>/SKILL.md 存在 | 整目录拷贝(来源未知或带运行时资源) |
third_party/<name>/INSTALL.md 或 README.md 含 git clone … | 在 ~/.claude/skills/ 下执行该 git clone 块 |
third_party/<name>/INSTALL.md 或 README.md 含 /plugin marketplace add … | 在脚本末尾打印这些斜杠命令 —— 让用户粘贴到 Claude Code 聊天框 |
默认不覆盖已存在的 skill 目录,加 --force 才会覆盖;重复跑是安全的。
流程
Step 1 — 定位归档目录
用户一般在项目里调用。脚本默认按 <archive>/installer/skills-bulk-installer-zh/scripts/install.sh 的位置往上推,自动找到归档根。如果不确定,先和用户确认路径。
Step 2 — 先 dry-run
动手前一定先让用户看到会发生什么:
bash <archive>/installer/skills-bulk-installer-zh/scripts/install.sh --dry-run
dry-run 会列出每条 COPIED / SKIP / MANUAL / GIT。和用户一起看一遍,确认无误再继续。
Step 3 — 正式安装
bash <archive>/installer/skills-bulk-installer-zh/scripts/install.sh
只有用户明确要覆盖已存在 skill 时才加 --force。脚本在执行 git clone 块前会询问 y/N,得到用户同意再跑。
Step 4 — 手动完成插件市场安装
脚本最后会打印类似这样的一块:
--- ACTION REQUIRED: paste these into Claude Code chat ---
/plugin marketplace add thedotmack/superpowers
/plugin install superpowers@thedotmack
...
把这一块念给用户,并提醒:Claude Code 的斜杠命令工具调用不到,必须人工粘贴到聊天框;粘完后建议重启会话让新插件 skill 生效。
往归档里添加新 skill
用户问"我新写了个 skill,怎么纳入批量安装?"时:
- 自定义 →
cp -r ~/.claude/skills/<name> <archive>/custom/<name>,下次批量安装会自动带上
- 第三方且可复现安装 → 在
<archive>/third_party/<name>/ 下建 INSTALL.md(或 README.md),里面写 git clone 或 /plugin 命令;安装器逐行解析
- 第三方来源不明 → 整个目录拷到
third_party/<name>/(SKILL.md 存在即触发全拷贝模式)
备注
- 脚本只用 bash,零依赖,干净机器即开即用
- 永远不删 skill —— 只有
--force 才覆盖(覆盖时为了 cp 语义会先删目标),其它路径下的文件不会动
- 如果某个第三方
README.md 同时含 git clone 和 /plugin 指令,两块都会处理(git 直接跑、plugin 行打印)