用途:把包含 SKILL.md 的单个 Skill 源目录,或含多个 Skill 子目录的集合目录,安装到本机已有的各类 Agent。用户始终使用同一条命令,脚本自动选择公共入口或专属入口,无需指定宿主类型或模式参数。
主要能力:公共入口写入 ~/.agents/skills/<skill-name>,供 Codex、GitHub Copilot、Gemini CLI、Cursor、Augment、Roo Code、OpenCode、OpenHands 等读取,避免重复显示。专属入口仅在对应主目录已存在时创建,覆盖 Claude Code(~/.claude/skills)、WorkBuddy(~/.workbuddy/skills)、Hermes Agent(~/.hermes/skills)、Kiro(~/.kiro/skills)、Qwen Code(~/.qwen/skills)、Cline(~/.cline/skills)。Unix-like 用符号链接,Windows 的 Bash/MSYS 用目录 Junction。本机存在 ~/.grok 时生成包含 user_invocable: true 并指向真源 SKILL.md 的薄适配层。执行 link 时自动清理指向同一真源的冗余链接、旧版宿主链接和旧别名,保留真实目录、真实文件及其他来源链接并报告冲突,不删除源 Skill。
使用方式:在 dbskill 仓库根目录运行: skills/dbs-install-skill/scripts/install-skill.sh link <skill-name-or-path> 查看状态: skills/dbs-install-skill/scripts/install-skill.sh status <skill-name-or-path> 卸载: skills/dbs-install-skill/scripts/install-skill.sh unlink <skill-name-or-path> 状态正常须输出“✓ 未发现冗余入口”,发现冗余则失败并报告。
适用场景:跨 Agent 安装、同步、查看、去重或卸载 Skill。
限制:源目录必须自身含 SKILL.md 或其一级子目录含 SKILL.md;入口名优先取真源 frontmatter 的 name,缺失时才用源目录名;不存在的 Agent 主目录不会创建(~/.agents 除外);不覆盖真实目录或文件;不会读取或安装 private/ 与 .private/;源目录不会被删除,卸载只移除派生产物。其余运行环境等细节暂未提供。