| 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 行打印）
