前言¶
如果你在 Claude Code、Cursor、Codex 里各自维护一套 Skill，改一处往往要手工再拷一遍。各平台虽然目录不同，但 Skill 本体都是开放的 SKILL.md 格式（YAML 前置元数据 + Markdown 指令，外加可选脚本与资源），理论上只需把技能文件夹从一个平台的 skills 目录复制到另一个。下面介绍 SkillHub 上的社区 Skill「AI Skill跨平台同步工具」，它把上述复制流程写成 Agent 可执行的说明，并配套 sync-skill 命令行工具完成同步。
这是什么¶
AI Skill跨平台同步工具（坐标 @user_3c6cb52e/sync-skill-b3jf，版本 1.0.0）是 SkillHub community 来源、分类 ai-agent 的技能包，由发布者 user_3c6cb52e 维护。官方简介为：同步技能专用技能，帮助 AI Agent 高效完成相关任务。
技能文档中的 sync-skill 定位是：将 Agent Skill 从一个 AI 工具复制到另一个，不做格式转换，只做目录间的文件夹同步。标签 requires_api_key=false，安装本 Skill 本身不需要 API Key；实际执行 npx sync-skill 时需本机具备 Node.js 环境。
SkillHub 页面数据（截至资料抓取）：评分 100000，下载 1278 次。
核心功能¶
根据技能包内 SKILL.md，已核实能力如下。
- 直接模式：指定源平台与目标平台，一次性复制该作用域下的全部 Skill。
- 交互模式：无参数启动向导，按「作用域 → 源平台 → 目标平台 → 勾选 Skill」逐步选择。
- 作用域：
global（默认，用户主目录下的个人 Skill）与project（当前工作目录下的工作区 Skill）。 - 覆盖确认：目标侧已有同名 Skill 时不静默覆盖，会提示并对比双方
version（若声明），需用户确认后才替换，且不保留备份。 - 元数据原样复制：不修改
SKILL.md前置字段；同步后提示你自行调整 Claude Code 特有的model、effort等字段。
支持的平台关键词（节选）：
| 平台 | 关键词示例 |
|---|---|
| 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 |
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已安装：
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
将本 Skill 装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常用路径如下：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令（与 SkillHub CLI 解析结果一致）：
skillhub install sync-skill-b3jf --namespace user_3c6cb52e --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你当前环境对应目录即可。SkillHub 技能页亦提示：可让 Agent 按 SkillHub 安装说明 安装 @user_3c6cb52e/sync-skill-b3jf。
运行同步工具的前置条件¶
技能文档中的验证清单要求 Node.js ≥ 18。同步操作通过 npx 拉取并运行 sync-skill 包，与「把 Skill 装进 Agent」是两步：前者复制技能文件夹，后者让 Agent 学会何时、如何调用该流程。
典型用法¶
直接模式：复制某平台下的全部 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 后，也可在对话中说明源平台、目标平台与作用域，让 Agent 按 SKILL.md 中的步骤代你执行上述命令并处理覆盖确认。
适用场景与注意¶
适合谁
- 在 Claude Code 与 Cursor 之间共用同一套 Skill。
- 多机或多工具协作，希望统一 Skill 集合。
- 新建仓库后，需要把各平台项目级 Skill 目录对齐。
限制与常见坑（均来自官方 SKILL.md）
- VS Code 与 GitHub Copilot CLI 的全局 Skill 共用
~/.copilot/skills/，在 global 作用域下互相同步可能等价于无操作。 --scope project依赖当前工作目录，请从项目根目录运行。- Windows 路径使用
%USERPROFILE%，OpenCode 使用%LOCALAPPDATA%。 - 确认覆盖会永久替换目标侧文件，无自动备份。
- 跨平台复制后，Claude Code 专用的模型相关字段仍需在目标环境手动改。
结尾¶
AI Skill跨平台同步工具把「多平台 skills 目录不一致」的问题收敛为可重复的复制流程：SkillHub 侧用标准 SKILL.md 教 Agent 何时同步，命令行侧用 npx -y sync-skill 完成文件夹级迁移。若你正在维护多套 Agent 技能，可先安装该 Skill，再按场景选择 global 或 project 作用域试跑一条同步命令。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_3c6cb52e/sync-skill-b3jf
- 官方坐标页：https://api.skillhub.cn/user_3c6cb52e/sync-skill-b3jf
