技能介绍

要解决的问题

当你同时在 Claude Code、Cursor、Codex 等工具里工作时，每个工具都有自己的 skills 目录。同一个 Agent Skill 往往要手动复制好几次，项目级和个人级的技能还要分别维护。SKILL.md 是开放的格式——一个 Skill 就是一个包含 SKILL.md（YAML 前置元数据加 Markdown 指令）以及可选脚本、资源的文件夹——既然所有支持的平台都读同一种格式，「同步」其实只是文件夹复制，不需要任何格式转换。sync-skill 把这件事做成一条命令。

它如何工作

直接模式一次性复制所有 Skill，交互模式则通过向导引导你依次选择作用域、源平台、目标平台，再勾选要复制的 Skill。

支持的平台包括 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI、VS Code 和 OpenCode，每个平台有对应的关键词。作用域分两种：--scope global（默认）同步主目录下的个人 Skill，--scope project 同步当前工作目录下的工作区 Skill。

三个值得注意的行为：

覆盖确认：源和目标出现同名 Skill 时，工具不会静默覆盖，而是告知冲突、显示双方声明的 version（如有），再询问是否替换。
模型字段原样复制：前置元数据里的通用字段（name、description、license 等）与 Claude Code 特有扩展（model、effort）不会被重写。复制完成后会打印报告，提醒你手动调整目标平台对应的模型值。
路径按操作系统标准化：同一命令在 Linux、macOS、Windows 上通用，Windows 上使用 %USERPROFILE%，OpenCode 使用 %LOCALAPPDATA%。

适用边界与注意点

VS Code 和 GitHub Copilot CLI 共享 ~/.copilot/skills/，在全局作用域下同步它们等同于无操作。项目作用域基于当前工作目录解析路径，因此要从项目根目录运行。最需要留意的是：确认替换等于永久替换，工具不保留任何备份——替换前先确认你不需要现有版本。