你会遇到什么

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

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

什么时候别用：纯 Linux/headless 环境——本条目只有 Windows/macOS 资产，没有 Linux 版（本环境未实测运行）。 注意事项：桌面 GUI 条目（Windows 10+ / macOS）；本文档基于 release 元数据 + 官方 README 审计，命令与预期效果如实标注来源。

本文路径：快速修复（30 秒一段命令）→ 一步步来（可跳读）→ 怎么确认修好了（成功判据）。赶时间直接跳到「快速修复」。

为什么会这样

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

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

装完它动哪里：~/.config/SkillDock / ~/.skilldock（应用配置）；同步技能时写各工具技能目录。

一步步来

第 1 步：装应用（Windows / macOS 二选一）

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

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 分支：

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 地址，技能入库并可选同步到目标工具。

# GUI：Skills → Install → 粘贴 Git 地址

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

装好确认：

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

卡住怎么办：

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

第 3 步：一键多工具同步 + Git 更新（GUI）

讲解：技能详情勾选目标工具 Sync 分发；Git 更新前预览 diff（上游更新 vs 本地修改），确认后 Update/Push。

# GUI：技能详情 → 勾选 Claude Code/Codex/Cursor → Sync

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

# GUI：技能列表 → 查看上游更新/本地修改 → 预览 → Update/Push

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

卡住怎么办：

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

怎么确认修好了

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

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

# GUI：打开 SkillDock，确认主界面与已扫描技能列表

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

卡住怎么办：

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

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

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

# GUI：Skills → Install → 粘贴 Git 地址 → 勾选目标工具 → Sync

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

卡住怎么办：

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

其它环境的表现（常见变体）

• 平台：只有 Windows（setup.exe）与 macOS（dmg）资产，无 Linux 版；x64 / aarch64 按平台选择。
• 写面：应用配置 ~/.config/SkillDock / ~/.skilldock；同步时写各工具技能目录（共享写面，同步前注意备份）。
• 桌面应用形态：无 CLI、无后台服务；共装无冲突矩阵对子（GUI 独立运行）。

日常使用

启动与入口

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

常用操作

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

# GUI：打开应用 → 自动扫描 Claude Code/Cursor/Codex/Windsurf 等技能目录

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

操作二：安装技能（Git 仓库 / skills.sh / ClawHub）

# GUI：Skills → Install → 粘贴 Git 地址

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

操作三：一键多工具同步

# GUI：技能详情 → 勾选 Claude Code/Codex/Cursor → Sync

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

操作四：Git 更新（追踪上游 + 本地修改）

# GUI：技能列表 → 查看上游更新/本地修改 → 预览 → Update/Push

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

数据与目录

• 应用配置：~/.config/SkillDock / ~/.skilldock；
• 同步时写各工具技能目录（Claude Code/Cursor/Codex 等）。

卸载与清理

note: 平台卸载程序 + 配置清理；被管理的共享配置不还原

# 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

依赖警告

• 版本：[1.0.15, 1.0.15] 锁定（收录结构确认版本）。
• 环境：Windows 10+ / macOS（无 Linux 资产）；x64 / aarch64 资产按平台选择。
• 网络：GitHub 直连慢，必须 gh-proxy 前缀（实测路径）。
• 写面：应用配置 ~/.config/SkillDock / ~/.skilldock；同步时写各工具技能目录（共享写面，同步前注意备份）。
• 共装：无冲突矩阵对子（桌面应用形态）。

FAQ（常见问题）

• 问：有 Linux 版吗？答：没有。本条目只有 Windows/macOS 资产。
• 问：同步会覆盖我手改的技能吗？答：Git 更新有 diff 预览（上游 vs 本地修改）；但多工具同步会写各工具技能目录，同步前注意备份。
• 问：和 skillspector 一起用？答：不同形态（桌面管理 vs 安全扫描），无共享写面冲突；安全建议：装完技能后用 skillspector 扫一遍再启用。
• 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口；项目自身问题请向作者仓库反馈。