技能管理 · 详细指南 · 验证于 2026-08-28

skilldock:详细版

AI 技能管理器桌面应用(Claude Code/Cursor/Codex 等技能安装、组织、Git 同步)

skilldock 详细指南

版本 1.0.15~1.0.15 | 分类 plugin-mgmt | 安全(已审查) | 素材:项目官方文档(英文 README/docs)+ 本市场实测(2026-08-28 结构确认)
配套:站内文档(manifest + guide + 证据)| 快速版:站内文档

1. 场景:什么时候会用它

SkillDock(wanghuan9 出品,MIT,492 星)是 AI 编码工具的桌面技能管理器:Claude Code、Cursor、Codex、Windsurf、Gemini CLI、GitHub Copilot 等工具的技能、MCP、插件在一个界面里管理。特点:按工具真实目录扫描(区分已管理/未管理/冲突)、Git 感知更新(追踪上游 + 本地修改 + 推送预览)、一键多工具同步。

一句话:技能界的"包管理器 + Git 客户端"——装、更新、同步、冲突一目了然。

这个工具解决什么问题:技能文件散在 Claude Code / Cursor / Codex 多个目录里,手动复制很容易乱。SkillDock 是一个桌面应用:安装、整理、git 同步各工具的技能——扫描技能目录、从 Git 仓库/skills.sh/ClawHub 安装技能、一键多工具同步、追踪上游更新与本地修改。

什么时候用:

  • 你同时在多个 Agent 上维护技能,想要一个管理入口;
  • 你要从 Git 仓库装技能并保持可更新;
  • 你要预览上游更新 diff 再决定是否应用。

什么时候别用:纯 Linux/headless 环境——本条目只有 Windows/macOS 资产,没有 Linux 版(本环境未实测运行)。

注意事项:桌面 GUI 条目(Windows 10+ / macOS);本文档基于 release 元数据 + 官方 README 审计,命令与预期效果如实标注来源。

2. 能力清单

能力作用
技能库管理(安装/更新/删除)见 Agent 执行版 guide
多工具技能同步(一键)见 Agent 执行版 guide
MCP 服务器管理见 Agent 执行版 guide
插件管理见 Agent 执行版 guide
Git 感知更新见 Agent 执行版 guide
冲突条目识别见 Agent 执行版 guide

3. 快速安装

note: Windows 资产(本环境结构确认);国内 GitHub 直连慢必须 gh-proxy 加速
# 来源: Trove 详细指南 · 验证于 2026-08-28
curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wanghuan9/skilldock/releases/download/v1.0.15/SkillDock_1.0.15_x64-setup.exe
./SkillDock_x64-setup.exe

预期输出: 安装向导(默认下一步完成)

第 1 步:确认应用能启动并扫描到技能

讲解:应用启动进入主界面、自动扫描到本机各工具技能目录,说明安装与读取链路都通。

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:打开 SkillDock,确认主界面与已扫描技能列表

预期输出: 应用主界面 + 本机工具技能目录列表

卡住怎么办:

  • 应用打不开 → 确认系统版本(Windows 10+ / macOS)与资产匹配(x64 vs aarch64);
  • 没扫到技能 → 确认目标工具的技能目录存在(SkillDock 读取的是各工具标准技能目录)。

第 2 步:确认技能安装与同步

讲解:从 Git 仓库装一个技能后出现在已管理列表,且 Sync 到目标工具后该工具的技能目录出现对应文件——技能管理链路即确认。

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:Skills → Install → 粘贴 Git 地址 → 勾选目标工具 → Sync

预期输出: 技能入库 + 分发到所选工具目录

卡住怎么办:

  • 装不上 → 确认仓库地址与网络;技能库格式是否符合应用要求(官方 README/docs 有说明);
  • 同步覆盖手改技能 → 同步前先备份(同步会写各工具技能目录)。

安装变体

路径命令实测
主路径(实测)curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wang…✅ 本市场实测
镜像/代理见快速版与 semi_auto_note;国内安装按 skilldock 指引实测
半自动说明:官方资产 v1.0.15(2026-08-19,6 资产)仅 Windows exe + macOS dmg/app——无 Linux 二进制(本环境 WSL 未实测运行);latest.json 元数据 + README 结构审计确认;桌面 GUI 形态;管理面 = 各 agent 技能目录(Claude Code/Cursor/Codex/Windsurf/Gemini CLI/Copilot)+ MCP 配置 + 插件;Git 感知更新(追踪上游 + 本地修改);安装 = 桌面应用安装向导
  • 平台:只有 Windows(setup.exe)与 macOS(dmg)资产,无 Linux 版;x64 / aarch64 按平台选择。
  • 写面:应用配置 ~/.config/SkillDock / ~/.skilldock;同步时写各工具技能目录(共享写面,同步前注意备份)。
  • 桌面应用形态:无 CLI、无后台服务;共装无冲突矩阵对子(GUI 独立运行)。

4. 为什么会这样(机制与共享面)

它怎么工作:安装器(Windows setup.exe / macOS dmg)装桌面应用。打开后自动扫描 Claude Code/Cursor/Codex/Windsurf 等技能目录,把技能分组为已管理/未管理/冲突;从 Git 地址/skills.sh/ClawHub 安装技能;一键同步到所选工具;Git 更新前预览 diff。

关键概念:

  • 技能目录扫描:自动发现各工具技能位置;
  • 多工具同步:一份技能分发到多个 Agent;
  • Git 更新:追踪上游 + 本地修改,预览后应用。

装完它动哪里:~/.config/SkillDock / ~/.skilldock(应用配置);同步技能时写各工具技能目录。

官方资产 v1.0.15(2026-08-19,6 资产)仅 Windows exe + macOS dmg/app——无 Linux 二进制(本环境 WSL 未实测运行);latest.json 元数据 + README 结构审计确认;桌面 GUI 形态;管理面 = 各 agent 技能目录(Claude Code/Cursor/Codex/Windsurf/Gemini CLI/Copilot)+ MCP 配置 + 插件;Git 感知更新(追踪上游 + 本地修改);安装 = 桌面应用安装向导

5. 常用操作

第 1 步:装应用(Windows / macOS 二选一)

讲解:Windows 用 setup.exe 安装向导;macOS 用 dmg 拖入 Applications。国内 GitHub 直连慢,下载走 gh-proxy 前缀。注意:本条目只有 Windows/macOS 资产,无 Linux 版。

# 来源: Trove 详细指南 · 验证于 2026-08-28
curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wanghuan9/skilldock/releases/download/v1.0.15/SkillDock_1.0.15_x64-setup.exe
./SkillDock_x64-setup.exe

预期输出: 安装向导(默认下一步完成)

macOS 分支:

# 来源: Trove 详细指南 · 验证于 2026-08-28
curl -sL -o SkillDock.dmg https://gh-proxy.com/https://github.com/wanghuan9/skilldock/releases/download/v1.0.15/SkillDock_1.0.15_aarch64.dmg
open SkillDock.dmg

预期输出: 拖入 Applications

装好确认:

  • 应用能启动并进入主界面;
  • 自动扫描到本机各工具技能目录。

卡住怎么办:

  • 下载慢 → 确认走 gh-proxy 前缀;换网络重试;
  • 应用打不开 → 确认系统版本(Windows 10+ / macOS)与资产匹配(x64 vs aarch64)。

第 2 步:从 Git 仓库装技能(GUI)

讲解:Skills → Install → 粘贴 Git 地址,技能入库并可选同步到目标工具。

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:Skills → Install → 粘贴 Git 地址

预期输出: 技能入库并可选同步到目标工具

装好确认:

  • 技能出现在已管理列表。

卡住怎么办:

  • 装不上 → 确认仓库地址与网络;技能库格式是否符合应用要求(官方 README/docs 有说明)。

第 3 步:一键多工具同步 + Git 更新(GUI)

讲解:技能详情勾选目标工具 Sync 分发;Git 更新前预览 diff(上游更新 vs 本地修改),确认后 Update/Push。

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:技能详情 → 勾选 Claude Code/Codex/Cursor → Sync

预期输出: 技能分发到所选工具(避免手抄文件)

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:技能列表 → 查看上游更新/本地修改 → 预览 → Update/Push

预期输出: 更新前预览 diff,确认后应用

卡住怎么办:

  • 同步覆盖手改技能 → 多工具同步会写各工具技能目录,同步前先备份;
  • Git 更新后行为变化 → 更新前仔细看 diff 预览,确认后再应用。

启动与入口

桌面应用,从开始菜单/Applications 启动。

常用操作

操作一:扫描各工具技能目录

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:打开应用 → 自动扫描 Claude Code/Cursor/Codex/Windsurf 等技能目录

预期输出: 已管理/未管理/冲突条目分组列表

操作二:安装技能(Git 仓库 / skills.sh / ClawHub)

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:Skills → Install → 粘贴 Git 地址

预期输出: 技能入库并可选同步到目标工具

操作三:一键多工具同步

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:技能详情 → 勾选 Claude Code/Codex/Cursor → Sync

预期输出: 技能分发到所选工具(避免手抄文件)

操作四:Git 更新(追踪上游 + 本地修改)

# 来源: Trove 详细指南 · 验证于 2026-08-28
# GUI:技能列表 → 查看上游更新/本地修改 → 预览 → Update/Push

预期输出: 更新前预览 diff,确认后应用

数据与目录

  • 应用配置:~/.config/SkillDock / ~/.skilldock;
  • 同步时写各工具技能目录(Claude Code/Cursor/Codex 等)。

6. 冲突逐条(摘要)

与工具页矩阵同源,共 19 对(0 实测兼容 / 12 推断可能兼容 / 7 推断可能冲突);完整对子、状态与证据见 冲突对子(共装矩阵)。

7. 排障速查

  • 暂无独立排障手册;安装/卸载问题先看 Agent 执行版 guide 注意事项

8. 卸载与残留检查

# 来源: Trove 详细指南 · 验证于 2026-08-28
rm -rf ~/.config/SkillDock ~/.skilldock 2>/dev/null || true
note: 平台卸载程序 + 配置清理;被管理的共享配置不还原
# 来源: Trove 详细指南 · 验证于 2026-08-28
# Windows:设置 → 应用 → 卸载 SkillDock;macOS:拖废纸篓
rm -rf ~/.config/SkillDock ~/.skilldock 2>/dev/null || true
ls ~/.config/SkillDock ~/.skilldock 2>/dev/null | grep -q . && echo '残留: SkillDock 配置仍在' || echo 'skilldock removed: OK'

预期输出: skilldock removed: OK

9. FAQ

  • 运行环境预检(Windows 10+ 或 macOS;本市场无 Linux 资产)
  • 官方 release 资产(本环境结构确认);国内 GitHub 直连慢必须 gh-proxy 加速
  • GUI 操作;每条 = 目标 + 预期效果;官方文档 = 项目 README/docs
  • 平台卸载程序 + 配置清理;被管理的共享配置不还原
  • 共享管理面:它管理各工具技能目录 + MCP 配置 + 插件注册——与 superpowers/agent-skills(技能目录)、omc/claude-mem(插件/MCP 注册)、ruflo/code-review-graph(MCP)、cc-switch(技能/MCP 管理)存在同面风险(本市场判定 possible-conflict)
  • 问:有 Linux 版吗?答:没有。本条目只有 Windows/macOS 资产。
  • 问:同步会覆盖我手改的技能吗?答:Git 更新有 diff 预览(上游 vs 本地修改);但多工具同步会写各工具技能目录,同步前注意备份。
  • 问:和 skillspector 一起用?答:不同形态(桌面管理 vs 安全扫描),无共享写面冲突;安全建议:装完技能后用 skillspector 扫一遍再启用。
  • 问:使用问题向谁反馈?答:本市场安装/卸载问题走条目反馈入口;项目自身问题请向作者仓库反馈。
  • 版本:[1.0.15, 1.0.15] 锁定(收录结构确认版本)。
  • 环境:Windows 10+ / macOS(无 Linux 资产);x64 / aarch64 资产按平台选择。
  • 网络:GitHub 直连慢,必须 gh-proxy 前缀(实测路径)。
  • 写面:应用配置 ~/.config/SkillDock / ~/.skilldock;同步时写各工具技能目录(共享写面,同步前注意备份)。
  • 共装:无冲突矩阵对子(桌面应用形态)。

10. 出处

  • 条目签名:wanghuan9/skilldock(MIT,原样收录 v1.0.15)
  • 实测:实测记录(本地留存)(2026-08-28,release 资产结构确认:Windows/macOS 下载地址与版本)。
  • 未实测:GUI 运行与技能同步(无 Windows/macOS 环境)——预期效果来自官方 README/docs,如实标注。

外部教学(来源未实测)

第三方教学未逐条实测,仅供学习;有出入以本页与官方文档为准。

收录来源(已合并)

本页内容由多篇来源文章按哈希去重、实测验证、AI 重写后合并而来——来源不散落,全部挂在这一个页面上。

暂无已合并来源:本页为本地实测与多来源重写的沉淀;来源与验证细节见站内对应方案页。

← 返回 skilldock 方案页 | 技能管理 问题域