如何把技能同步到 Claude Code、Codex、Cursor 和 OpenCode

每個工具讀取的位置

資料來自各工具的文件，2026 年 11 月 4 日查閱。每個資料夾中，每個技能一個子資料夾，裡面放一份 SKILL.md。

兩個資料夾就能涵蓋全部四個工具：~/.claude/skills（Claude Code、Cursor、OpenCode）和 ~/.agents/skills（Codex、Cursor、OpenCode）。

在你的電腦上只留一份：符號連結

把實際的檔案放在一個資料夾，再讓兩個位置都指向它。在 macOS 或 Linux 上：

mkdir -p ~/skills
# move existing skills in first, then:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

如果其中一個資料夾已經存在，請先把裡面的內容搬到 ~/skills，刪除空資料夾後再建立連結。Cursor 和 OpenCode 兩個位置都會讀，所以會從兩條路徑讀到同樣的檔案。如果某個技能出現兩次，它其實仍是同一個檔案：在 ~/skills 中改一次就好。

在儲存庫中，對 .claude/skills 和 .agents/skills 做同樣的事，提交實際的資料夾，每個複製儲存庫的人就都會拿到這些技能。

團隊只留一份：MCP 伺服器

符號連結和儲存庫對開發者有用，但送不到在瀏覽器中用 Claude 或 ChatGPT 工作的隊友，而且需要 git pull 才能更新。這四個程式設計代理也都能連接遠端 MCP 伺服器：

• Claude Code：claude mcp add --transport http <name> <url>
• Codex：在設定檔中加入含 url = "…" 的伺服器項目（Streamable HTTP）。
• Cursor：在 MCP 設定中加入 Streamable HTTP 伺服器。
• OpenCode：在設定檔中加入含 "type": "remote" 的伺服器。

一台存放團隊技能的伺服器，能讓程式設計代理、Claude 和 ChatGPT 都拿到同一份最新版本，不需要 pull，也不需要重新連結。

確認工具看得到你的技能

1. 檢查結構：<folder>/<skill-name>/SKILL.md，資料夾名稱要和 name 欄位相同。
2. 檢查前置資料：name 只能用小寫英文字母、數字和連字號，最多 64 個字元，description 不能是空的。SKILL.md 轉換器會把兩者都寫好。
3. 開啟新的工作階段，問代理它有哪些技能，或請它做說明中寫到的工作。

常見問題

要怎麼讓 Claude Code 的技能和 Claude 桌面版、claude.ai 同步？

Claude Code 讀取磁碟上的資料夾；Claude 桌面版和 claude.ai 則把上傳的技能存在你的帳號中。把同一個資料夾壓縮成 ZIP，到 Customize > Skills 上傳，或讓兩者連接到一台提供技能的 MCP 伺服器。

為什麼 Claude Code 看不到我的 .agents/skills 資料夾？

Claude Code 讀取的是 ~/.claude/skills 和 .claude/skills，不是 .agents/skills。照上面的符號連結步驟，把資料夾連結到 ~/.claude/skills。