Skill 名称：sync-skill
简称：同步技能工具
来源：社区第三方（开发者：william-garden）
运行宿主：Claude-Code CLI
核心定位：一键实现跨编码 Agent 和 IDE 的 AI Agent Skills（SKILL.md）同步，适用于多开发环境下的技能文档统一管理。

🧩 内部核心组成

该 Skill 主要围绕技能文档的同步功能构建，核心组成如下：

主要功能组件

同步引擎：负责检测并同步不同 Agent 或 IDE 中的 SKILL.md 文件。
配置管理：用于自定义同步路径与目标环境。

斜杠命令

命令名	功能简述
`/sync`	触发技能文档同步流程
`/config`	配置同步目标路径或环境

🛠 安装与启用方式

安装命令：

```bash

skills install --user william-garden/sync-skill

```

前置依赖：需确保已安装 Claude-Code CLI 并具备基本的 skills 管理功能。

启用方式：安装后，在 Claude-Code CLI 中直接使用 /sync 或 /config 命令即可启用。

📋 标准工作流

用户输入指令：例如输入 /sync。
Skill 响应：自动检测当前环境中的 SKILL.md 文件。
同步执行：将技能文档同步至预设的目标 Agent 或 IDE 环境。
完成反馈：同步完成后，返回操作结果及同步路径信息。

⚠️ 关键限制、缺陷、注意事项

平台限制：仅支持 Claude-Code CLI，无法用于其他 Agent 工具（如 Cursor、MCP 或 OpenAI Agent）。
适用项目：适合需要在多个开发环境之间同步技能文档的项目。
不适用场景：不适用于非 Claude-Code CLI 环境或无需技能同步的简单项目。
生产环境：由于属于社区第三方工具，建议在测试环境中验证稳定性后再考虑生产使用。

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

需要在多个 Claude-Code CLI 环境中同步 SKILL.md 文件的开发者。
团队协作开发，希望统一管理 AI Agent 技能文档的项目。

❌ 不适合场景

非 Claude-Code CLI 用户或环境。
单一开发环境，无需跨环境同步的简单应用。

如何安装

skills install --user william-garden/sync-skill

通用安装教程：在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：

打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
把上面的安装命令复制进去，回车运行，等待下载与注册完成。
重启或重新加载 AI 工具，让新安装的 Skill 被识别。
新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。

Claude 桌面版（macOS / Windows）

桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。

Claude Code（终端 CLI）

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。

VS Code（含 GitHub Copilot）

打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。

Windsurf

底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。

其他工具（ChatGPT、本地脚本等）

不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。

风险提示

✅ 低风险

自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。