sync-skill — AI Skill 跨平台同步工具
概述
sync-skill 将你的 Agent Skill 从一个 AI 工具复制到另一个。Agent Skill 使用开放的 SKILL.md 格式——一个 Skill 就是一个包含 SKILL.md 文件（YAML 前置元数据 + Markdown 指令）和可选脚本/资源的文件夹。因为所有支持的平台读取相同格式，同步就是把 Skill 文件夹从一个平台的 skills 目录复制到另一个——无需格式转换。
适用场景
- 在 Claude Code 和 Cursor 之间同步 Skill
- 把项目级 Skill 从 Claude Code 同步到 Codex
- 在多个 AI 编码工具间统一 Skill 集合
- 新建项目后快速设置各平台的 Skill
使用方法
直接模式（复制所有 Skill）
npx -y sync-skill <source> <target> [--scope global|project]
示例：
# 把 Claude Code 的全局 Skill 同步到 Cursor
npx -y sync-skill claude cursor
# 把 Claude Code 的项目级 Skill 同步到 Codex
npx -y sync-skill claude codex --scope project
交互模式（选择单个 Skill）
npx -y sync-skill
向导会引导你：作用域 → 源平台 → 目标平台 → 勾选要复制的 Skill。
支持的平台
| 平台 | 关键词 |
|---|---|
| Claude Code | claude, claude-code, anthropic |
| Codex | codex, openai |
| Cursor | cursor, cursor ide |
| Gemini CLI | gemini, google |
| GitHub Copilot CLI | copilot, github, gh |
| VS Code | vscode, vs code, code |
| OpenCode | opencode |
作用域
--scope global（默认）：主目录下的个人 Skill--scope project：当前工作目录下的工作区 Skill
覆盖确认
当源 Skill 与目标同名 Skill 重名时，sync-skill 不会静默覆盖，而是：
1. 告知目标已有此 Skill
2. 显示源和目标的 version（如有声明）
3. 询问确认替换
确认替换 = 永久替换，不保留备份。
模型相关字段
Skill 的 SKILL.md 前置元数据中有通用字段（name、description、license 等）和 Claude Code 特有扩展（model、effort）。
sync-skill 从不重写这些值——它原样复制，然后打印报告提醒你手动编辑目标平台对应的模型值。
常见问题与陷阱
- VS Code 和 GitHub Copilot CLI 共享
~/.copilot/skills/——全局作用域同步它们被视为无操作 --scope project基于当前工作目录解析路径——请从项目根目录运行- Windows 上路径使用
%USERPROFILE%，OpenCode 使用%LOCALAPPDATA% - 不保留备份——确认前确保不需要现有版本
- 路径按操作系统标准化——同一命令在 Linux、macOS、Windows 上通用
验证清单
- [ ] Node.js ≥ 18
- [ ] 源和目标平台名称正确
- [ ] 作用域选择正确（global vs project）
- [ ] 已检查覆盖确认提示
- [ ] 已知悉模型相关字段需要手动调整
- [ ] 项目作用域时从项目根目录运行
