SkillDock：Claude Code/Cursor 的 Skill 和 MCP 终于有“管家“了，Rust 写的桌面 App

开篇：你的 ~/.claude/skills/ 是不是也乱成一锅粥了

用 Claude Code、Cursor、Codex 超过一个月，你大概率会遇到这种情况：

1. 跟着各种教程装了十几个 Skill，~/.claude/skills/ 里十几个目录，哪个在用、哪个没在用早忘了；

2. 同一个 MCP Server（比如 filesystem、github、postgres），在 Claude Code 配了一遍，Cursor 又要配一遍，Windsurf 再来一遍——mcp.json 复制粘贴到吐；

3. 装了插件包（plugin），里面捆绑了一堆 skill、command、agent，想关其中一个不知道在哪关；

4. Skill 上游更新了，你不知道；你本地改过，更新时怕冲突；

5. 团队想共享一套内部 Skill，只能丢个 Git 仓库让人手动 clone，没有统一管理。

命令行不是不能管，但 ls ~/.claude/skills/、cat ~/.claude/mcp.json、git -C ... pull 这么来回切，累。

最近挖到一个叫 SkillDock 的开源桌面 App，Rust + Tauri 写的，专门干这件事：

一个桌面应用，统一管理 Claude Code、Cursor、Codex、Windsurf、Gemini CLI、GitHub Copilot 等 30+ AI 编码工具的 Skill、MCP Server 和插件。

最戳我的两个点：

• 真实目录扫描：不是注册个名字完事，是直接扫各工具的 skill 目录、mcp 配置文件，managed/unmanaged/conflict 一目了然；

• Git-aware Diff：Skill 是 Git 仓库的，上游更新、本地修改、待推送都可视化，Diff 预览、单文件/hunk 回滚。

这篇是我在 Windows 11 上实测的完整笔记，含安装、配置、踩坑、团队玩法。

---

目录

1. SkillDock 是什么

2. 支持 30+ AI 编码工具

3. 核心概念：Managed vs Enabled

4. Windows 安装

5. 第一次启动：扫描已有 Skill 和 MCP

6. Skill 管理实操

7. MCP Server 管理实操

8. Plugin（插件包）管理

9. 一键多工具同步

10. Git-aware Diff：上游更新和本地修改

11. 企业内部 Skill 市场

12. 常见坑

13. 适合谁 / 不适合谁

---

一、SkillDock 是什么

按官方 README 的说法：

SkillDock is desktop skill management software for AI coding tools: an AI skill manager for Claude Code, Cursor, Codex, Windsurf, and more. It also manages MCP servers and plugins, with Git-aware updates for tracking upstream changes and local modifications.

拆开看，它管三类东西：

类型	是什么	举例
Skill	可复用的 AI 能力包（指令 + 资源）	guizang-ppt-skill、chubbyskills
MCP Server	Model Context Protocol 服务器	@dbx-app/mcp-server、@figwright/mcp
Plugin	捆绑 skill/agent/command/MCP 的包	Claude Code 插件市场里的各种插件

它不是又一个 Skill 市场（虽然它能从 skills.sh、ClawHub、MCP.Directory 装），而是一个本地管理控制台——你所有 AI 工具里散落的配置、Skill、插件，统一在一个 GUI 里看。

---

二、支持 30+ AI 编码工具

官方列表（v1.0.8）：

Claude Code · Codex · Cursor · Windsurf · IntelliJ IDEA · OpenCode · Gemini · Antigravity · Continue · GitHub Copilot · Qwen Code · Trae · Trae CN · Cline · Roo Code · Kilo Code · Kiro · Goose · Junie · Augment · CodeBuddy · Droid · OpenClaw · CommandCode · Crush · Qoder · Zencoder · Hermes · iFlow · Pi · OMP · Grok Build · MiMo Code · WorkBuddy

这覆盖了目前主流的 AI 编码工具，包括国内的 Trae、Qwen Code、MiMo Code、CodeBuddy。

工具支持分两层：

1. 真实目录扫描：知道这个工具去哪个目录读 skill、读哪个 JSON 配 MCP；

2. 同步链接：可以把 managed skill 通过 symlink 链接到工具的 skill 目录。

---

三、核心概念：Managed vs Enabled

这是 SkillDock 最关键的设计，理解了就懂了它怎么干活。

3.1 Managed（被管理）

指这个 Skill 的真实文件放在 SkillDock 的中央仓库 ~/.skilldock/skills/ 下，由 SkillDock 负责更新、删除、Git 跟踪。

来源有三种：

进入方式	落地位置	能做什么
从 SkillDock 市场/Git/本地装	~/.skilldock/skills	检查、编辑、删除、分发到多个工具，Git 源支持 Diff/更新/推送
用 Agent Skills CLI 全局装（npx skills add -g）	~/.agents/skills	打开兼容开关后自动识别，可检查和分发
已经在各工具本地目录	导入后拷贝到 ~/.skilldock/skills	导入前是 unmanaged，导入后可管理

3.2 Enabled（已启用）

指这个 Skill 在某个具体工具里可用。一个 managed Skill 可以同时 enable 到 Claude Code、Cursor、Codex 多个工具。

实现方式是 symlink（符号链接）：SkillDock 中央仓库里的真实文件，链接到各工具自己的 skill 目录。

这样：

• 装一次，所有工具能用；

• 更新只更新中央仓库；

• 删除只删 symlink，不动源文件。

3.3 三种状态

在 UI 里每个 Skill 会显示：

• Managed + Enabled：你装的、正在用；

• Managed + Disabled：你装的但暂时关了；

• Unmanaged：散落在工具目录里 SkillDock 还没接管的——可以一键导入。

---

四、Windows 安装

4.1 前置

• Windows 10/11 x64；

• 不需要 Node.js/Python（App 自带）；

• 但你本机的 AI 工具（Claude Code、Cursor 等）要先装好。

4.2 下载

去 Releases 页：https://github.com/wanghuan9/skilldock/releases/latest

下载 Windows x64 的 .msi 或 .exe 安装包，双击安装。

或者用 WinGet（如果已上架）：

winget install wanghuan9.skilldock

4.3 macOS 注意

SkillDock 目前没有 Apple 公证，macOS 第一次打开会拦。装完执行：

sudo xattr -cr /Applications/SkillDock.app

然后正常启动。

4.4 启动

开始菜单搜 SkillDock，首次启动会让你选：

• App 数据存储目录（默认 ~/.skilldock）；

• 默认编辑器（VSCode/JetBrains/系统默认）；

• 是否开启 Agent Skills CLI 兼容；

• 主题（浅色/深色/跟随系统）。

---

五、第一次启动：扫描已有 Skill 和 MCP

启动后 SkillDock 自动扫描所有支持工具的真实目录：

• ~/.claude/skills/；

• ~/.cursor/skills/（或 Cursor 配置目录）；

• ~/.codex/skills/；

• ~/.config/windsurf/...；

• 以及对应工具的 mcp.json / settings.json。

扫完会给你一个清单：

• Managed by SkillDock：空（刚装）；

• Unmanaged：你以前手动装的所有 Skill；

• MCP Servers：各工具配置里的 MCP Server；

• Plugins：已装的插件包。

每个条目都能直接操作：

• Import：把 unmanaged 的 skill 导入到 ~/.skilldock/skills/ 接管；

• Remove from tool：只从这个工具的目录里删除（不影响其他工具）；

• Enable on：勾选其他工具，一键 symlink 过去。

---

六、Skill 管理实操

6.1 从市场安装

SkillDock 内置两个市场：

• skills.sh：Agent Skills 官方市场；

• ClawHub：360 安全龙虾的市场。

点 Install → Marketplace，搜索、点 Install 就行。下载、解压、放到中央仓库一气呵成。

6.2 从 Git 仓库安装

如果你想用的 Skill 在 GitHub 上但没上架市场：

Install → Git → 填入 https://github.com/xxx/yyy

SkillDock 会 git clone 到中央仓库，后续能检查更新、看 Diff。

6.3 从本地目录安装

自己开发的 Skill：

Install → Local Folder → 选择目录

6.4 视图

• 按来源分组（市场/Git/本地/Agent Skills CLI/工具原生）；

• 按工具分组（Claude Code 有哪些、Cursor 有哪些）；

• 卡片视图 / 列表视图；

• 过滤：managed/unmanaged/conflict/updateable。

6.5 编辑

点一个 Skill 进入详情：

• 元数据（名称、版本、来源、Git 状态）；

• 文件树（点开用默认编辑器改）；

• 在哪些工具启用了；

• 本地改动 / 上游更新状态。

---

七、MCP Server 管理实操

这是我最喜欢的部分。

7.1 自动扫描

SkillDock 会读每个工具的 MCP 配置文件，列出来：

• Server 名称；

• 启动命令和参数；

• 来源（哪个工具配置的）；

• 是否可用（健康检查）；

• 暴露了哪些 tools（展开看）。

7.2 一个 MCP 多工具共享

以前你要在 Claude Code、Cursor、Codex 的配置文件里各写一遍：

{ "command": "npx", "args": ["-y", "@figwright/mcp@latest"] }

现在在 SkillDock 里配一次，勾选要启用的工具，它自动写各工具的配置文件。

7.3 从 MCP.Directory 装

内置 MCP.Directory 市场索引，搜索、安装、配置一步到位。

7.4 工具级别开关

某个 MCP Server 暴露了 20 个工具，但你只想让 AI 用其中 3 个——可以在详情里按工具勾选启用。

7.5 健康检查

SkillDock 会尝试启动每个 MCP Server（短连接列工具），失败的标红，错误信息直接显示。不用等 AI 调用时才发现连不上。

---

八、Plugin（插件包）管理

Plugin 是更高一层的打包单位，可以包含：

• 多个 Skill；

• 自定义 Agent；

• Slash Commands；

• MCP 集成；

• 宿主工具特定的钩子。

典型例子：Claude Code 的插件市场里那些"完整开发工作流包"。

SkillDock 把 Plugin 作为一等公民：

• 列所有已装插件；

• 展开看它捆绑了哪些 skill/command/agent；

• 按工具启用/禁用整个插件；

• Git 来源的插件支持一键更新、看本地改动、待推送。

---

九、一键多工具同步

场景：你装了一个 springboot-patterns skill，想让 Claude Code、Cursor、Codex 都能用。

传统方式：

cp -r ~/.claude/skills/springboot-patterns ~/.cursor/skills/
cp -r ~/.claude/skills/springboot-patterns ~/.codex/skills/

更新时要重复三次。

SkillDock 方式：

在 Skill 详情页勾选三个工具的开关，保存。SkillDock 自动建 symlink。

更新时：

Update → 选择源 → Pull

中央仓库更新一次，三个工具立即可见（symlink 自动跟进）。

---

十、Git-aware Diff：上游更新和本地修改

这是 SkillDock 比其他管理工具高出一截的地方。

10.1 三种状态

来自 Git 仓库的 Skill/Plugin，会显示：

• Up to date：本地没改、上游没更新；

• Update available：上游有新 commit；

• Locally modified：你本地改过；

• Pending push：你本地改过并 commit 了但没推；

• Conflicted：上游和本地都改了同一文件。

10.2 Diff 预览

点 Review changes，打开 diff 视图：

• 按文件列；

• 每个文件展开看具体 hunk；

• 可以回滚单个文件或单个 hunk；

• 上游更新的 diff 也一样可视化，不会无脑覆盖你的修改。

10.3 团队场景

团队维护一个内部 Skill 仓库：

1. 所有成员用 SkillDock 从内部 Git 装这个 Skill；

2. 有人改进了，push 到中央仓库；

3. 其他人 SkillDock 显示 "Update available"；

4. Review Diff → Update；

5. 谁本地有自定义，SkillDock 会提示冲突而不是强行覆盖。

这比"发个群通知让大家 git pull"规范多了。

---

十一、企业内部 Skill 市场

README 里专门有一节讲企业集成，几个点：

• 连接内部市场：SkillDock 支持接企业自建的 Skill marketplace，从一个地方发现、下载、安装、更新内部 Skill；

• 连接内部发布平台：本地改动走企业的 review、发布、上架流程；

• 适配器架构：发布用 adapter，marketplace 集成复用数据模型，容易扩展；

• 数据自主可控：私有代码、凭据、业务数据不出企业；

• MIT 协议：可以魔改。

对于想用 AI 编码工具但又有合规要求的中大型团队，这是个可行的私有化方案——比从零做一套管理平台省太多。

---

十二、常见坑

Q1：Windows 上 symlink 权限报错

Windows 创建 symlink 需要开发者模式或管理员权限。

解决：

• 设置 → 更新和安全 → 开发者选项 → 打开"开发人员模式"；

• 或者以管理员身份运行 SkillDock。

不开的话 SkillDock 会 fallback 到"复制文件"模式，但那样就不能自动跟进更新了。

Q2：扫描不到 Cursor 的 skill

确认你用的是最新版 Cursor，老版本 Cursor 没有 skill 目录。检查：

dir $env:USERPROFILE\.cursor\

没有的话先在 Cursor 里装一个任意 Skill 触发目录创建。

Q3：Agent Skills CLI 装的全局 Skill 看不到

打开 Settings → Agent Skills CLI Compatibility，它会额外扫 ~/.agents/skills/。这些 Skill 不被移动到 SkillDock 中央仓库，但可以检查和分发。

Q4：更新 Skill 后 AI 工具没识别到

• Claude Code：需要重启会话（/exit 再进）；

• Cursor：Ctrl+Shift+P → Reload Window；

• 部分工具会自动检测，看工具文档。

Q5：MCP Server 健康检查失败

点进去看错误日志。常见：

• npx 不在 PATH（和 Figwright 那篇讲的一样，要填绝对路径）；

• Node 版本太低；

• 远程 MCP 网络不通；

• 环境变量没设（比如 API Key）。

在 SkillDock 里直接改 command/args/env，保存后各工具配置同步更新。

Q6：macOS 打不开"无法验证开发者"

sudo xattr -cr /Applications/SkillDock.app

Q7：和 npx skills CLI 冲突吗

不冲突，反而能共存。SkillDock 可以识别 CLI 装的全局 Skill（开兼容开关）。你可以：

• 用 CLI 做自动化脚本；

• 用 SkillDock 做可视化管理。

Q8：能管理非 Git 来源的 Skill 吗

能，但没有 Diff/更新功能。从市场装的有版本号，从本地文件夹装的就是静态的。

Q9：数据存在哪里？会上传吗？

• 所有数据在 ~/.skilldock/；

• 没有云同步、没有账号、没有遥测；

• Git 操作是直接调用你本机的 git，走你配置的 remote。

---

十三、适合谁 / 不适合谁

✅ 适合

• 同时用 2 个以上 AI 编码工具（比如 Claude Code + Cursor + Codex）的人；

• Skill / MCP 装了一堆，管不过来；

• 团队需要共享和版本化内部 Skill；

• 怕 AI 工具乱改 MCP 配置，想要一个"上帝视角"；

• 喜欢 Git 工作流，想要 diff/revert/branch；

• 企业要私有化部署 Skill 平台。

❌ 不适合

• 只用一个 AI 工具，也没装几个 Skill——ls 就够了；

• 完全命令行党，拒绝 GUI；

• 需要 Linux 桌面版的（README 说目前只支持 macOS Apple Silicon 和 Windows x64，Linux 还在 Roadmap）；

• 想云端同步多台机器的（SkillDock 故意不做云）。

⚠️ 注意

• SkillDock 会修改各工具的配置文件（mcp.json 等），第一次用建议先备份；

• 卸载 SkillDock 不会自动删除 ~/.skilldock/ 和已建立的 symlink，手动清理；

• 从第三方市场装 Skill/MCP 前，先看源代码，别什么都给权限。

---

最后总结

AI 编码工具的生态在 2026 年彻底爆发了——Skill、MCP、Plugin 每天都有新东西，但管理这些工具的工具反而没人认真做。SkillDock 填了这个空。

它的几个设计决策很对我胃口：

• 真实目录扫描而不是注册表：所见即所得，不做"影子状态"；

• Git-aware 而不是强制覆盖：尊重本地修改，diff 透明；

• symlink 分发而不是复制：一次更新多处生效；

• 本地优先不做云：符合 AI 工具用户的隐私偏好；

• Rust + Tauri：安装包小、内存低、启动快。

如果你已经装了 Chubby Skills、guizang-ppt-skill、Figwright、dbx MCP 这些东西，那你正需要 SkillDock。

项目地址：https://github.com/wanghuan9/skilldock Release 下载：https://github.com/wanghuan9/skilldock/releases/latest