dbs-install-skill
将单个 Skill 或 Skill 集合安装到通用 Agents、Claude Code、Codex、WorkBuddy、Grok、Hermes Agent、Kiro、Qwen Code、Cline 等 Agent。用户要求跨 Agent 安装、同步、查看、去重或卸载 Skill 时使用。
By dontbesilent2025 · 3,299 installs
npx skills add dontbesilent2025/dbskill --skill dbs-install-skill
Source repository · Upstream listing
dbs install skill：多端 Skill 安装与同步
把任意包含 SKILL.md 的 Skill 源目录，或包含多个 Skill 子目录的集合目录，安装到本机已经存在的 Agent。
用户始终使用同一条命令。脚本自动选择公共入口或专属入口，用户无需判断宿主类型，也无需添加模式参数。
自动路由
公共入口
脚本始终把 Skill 链接写入：
通用 Agents： ~/.agents/skills/<skill name
以下客户端可以读取该公共入口，因此不再写入各自的专属目录：
Codex；
GitHub Copilot；
Gemini CLI；
Cursor；
Augment；
Roo Code；
OpenCode；
OpenHands。
同一个 Skill 不会同时出现在 ~/.agents/skills 和上述客户端的专属目录中。这样可以避免 Codex 等客户端重复显示。
专属入口
以下客户端当前仍使用专属目录。只有对应主目录已经存在时，脚本才创建链接：
Claude Code： ~/.claude/skills/<skill name ；
WorkBuddy： ~/.workbuddy/skills/<skill name ；
Hermes Agent： ~/.hermes/skills/<skill name ；
Kiro： ~/.kiro/skills/<skill name ；
Qwen Code： ~/.qwen/skills/<skill name ；
Cline： ~/.cline/skills/<skill name 。
Unix like 系统使用符号链接；Windows 的 Bash／MSYS 环境使用目录 Junction，避免 ln s 在部分配置下生成实体目录副本。
Grok 薄适配层
本机存在 ~/.grok 时，脚本生成：
~/.grok/skills/<skill name /SKILL.md
该文件必须包含 user invocable: true ，并指向真源 SKILL.md 。
自动清理
每次执行 link 时，脚本同时处理历史遗留项：
1. 删除公共入口兼容客户端专属目录中指向同一真源的冗余链接；
2. 删除旧版脚本曾写入、当前已停止维护的宿主链接；
3. 删除同一宿主中指向同一真源、且规范名称已经存在的旧别名；
4. 集合安装时删除指向集合内已失效源目录的断裂链接和 Grok 适配层；
5. 保留真实目录、真实文件以及指向其他来源的链接，并报告冲突；
6. 不删除源 Skill。
核心原则
1. 一个公共入口。 支持通用 Agents 目录的客户端统一读取 ~/.agents/skills 。
2. 必要时补专属入口。 仅给当前仍依赖原生目录的客户端创建链接。
3. 用户无需选择模式。 脚本不要求用户提供路由参数。
4. 公共兼容客户端只保留一份。 Codex 等客户端不能同时存在公共入口和专属入口。
5. 各宿主只使用链接。 Windows 使用目录 Junction，Unix like 系统使用符号链接；Grok 是唯一使用薄适配层的宿主。
6. 不创建不存在的 Agent 主目录。 ~/.agents 是公共安装入口，可以由脚本创建；其他 Agent 主目录不存在时直接跳过。
7. 不覆盖真实目录。 目标位置已有真实目录或文件时，保留并报告；Windows 上提示它可能是旧版 MSYS 生成的实体副本。
8. 卸载只删派生产物。 unlink 只删除指向指定真源的符号链接或 Junction，以及本工具生成的 Grok 适配层。
9. 优先使用脚本。 使用本 Skill 自带的 scripts/install skill.sh ，不要临场重写安装命令。
确定源 Skill
用户可能提供：
Skill 名称： dbs hook ；
相对路径： skills/dbs hook ；
绝对路径： /Users/.../dbskill/skills/dbs hook ；
外部 Skill： /Users/.../external skills/lark doc ；
Skill 集合目录： /Users/.../dbskill/skills ；
当前上下文刚创建或刚修改的 Skill。
按以下优先级判断：
1. 用户给了绝对路径，直接使用；
2. 用户给了相对路径，先按当前工作目录解析，再按 dbskill 仓库根目录解析；
3. 用户只给 Skill 名称，先查当前工作目录，再查 dbskill 仓库 skills/<name ；
4. 用户只说“这个 Skill”，使用当前对话刚创建、改名或讨论的 Skill；
5. 仍不确定时，查看当前工作目录和仓库 skills/ 下最近修改的 Skill；
6. 仍无法确定时，只问一句： 安装哪个 Skill？给我 Skill 名称或路径。
源目录必须满足以下任一条件：
目录本身包含 SKILL.md ；
目录的一级子目录中包含一个或多个 SKILL.md 。
入口名优先读取真源 SKILL.md frontmatter 中的 name ；只有 name 缺失时才退回源目录名。这样源目录可以使用分类前缀，各 Agent 仍保持稳定的历史触发名。
执行安装
在 dbskill 仓库根目录运行：
示例：
执行完成后，根据脚本输出回报公共入口、专属入口、Grok 适配层和冗余清理结果。
查看状态
用户问“装好了吗”“有没有重复”“查看安装状态”时运行：
状态正常时，脚本必须输出：
公共兼容客户端的专属目录中仍有同源链接时，状态返回失败并报告：
卸载 Skill
用户说“卸载 Skill”“取消安装”“unlink”时运行：
完成后告诉用户：源 Skill 没有被删除，只移除了公共入口、专属入口和 Grok 适配层等派生产物。
输出规范
安装完成后简短回报：
遇到真实目录或其他来源时：
自检
每次执行前后确认：
源目录存在；
源目录包含 SKILL.md ，或其一级子目录包含 SKILL.md ；
入口名与真源 frontmatter name 一致；缺失 name 时才使用源目录名；
外部路径使用绝对路径，或能从当前工作目录解析；
~/.agents/skills/<name 是公共规范入口；
Codex 等公共兼容客户端的专属目录中没有同源链接；
专属宿主目标位置若存在，必须是指向当前真源的符号链接或 Junction；
Grok 目标位置若存在，必须是本工具生成的 Grok 适配层才允许更新；
真实目录、真实文件和其他来源链接没有被删除；
源目录没有被删除；
private/ 与 .private/ 没有被读取、复制、暂存或安装。
完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 /dbs 时，简短提示：「下一步不确定时，可以输入 /dbs 。」