前言¶
如果你在 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
