簡短回答
- 1資料夾:Claude Code 讀取
~/.claude/skills。Codex 讀取~/.agents/skills和舊版的~/.codex/skills。Cursor 讀取自己的資料夾,以及前面這兩個。 - 2用名稱呼叫:Claude Code 和 Cursor 用
/skill-name,Codex 用$skill-name。 - 3必填欄位:Codex 和 Cursor 需要
name和description,而且 Cursor 的name必須與資料夾名稱相同。Claude Code 兩者都不強制。
Claude Code、Codex 與 Cursor 一覽
三者都遵循相同的 Agent Skills 格式,所以結構正確的 Skill 資料夾在任何一個中都能執行。不同的是各 Agent 搜尋的位置、呼叫 Skill 的方式,以及對 frontmatter 的嚴格程度。
| Claude Code | Codex | Cursor | |
|---|---|---|---|
| 個人資料夾 | ~/.claude/skills/ | ~/.agents/skills/,舊版 ~/.codex/skills/ | ~/.cursor/skills/ 或 ~/.agents/skills/ |
| 專案資料夾 | .claude/skills/ | .agents/skills/,從你啟動的位置一路往上到 repo 根目錄 | .cursor/skills/ 或 .agents/skills/ |
| 查看已安裝項目 | /skills | /skills(CLI、IDE);ChatGPT 桌面版側邊欄的 Skills | Customize → Skills |
| 用名稱呼叫 | /skill-name | $skill-name | /skill-name 或 @skill-name |
| 必填欄位 | 無 | name、description | name(= 資料夾名稱)、description |
| 同名出現兩次 | 先 Enterprise,其次個人,最後專案 | 兩者都可能出現 | 文件未說明 |
| 修改之後 | 在同一個工作階段中生效 | 會生效;沒生效就重新啟動 | 啟動時讀取;開新對話或重新載入 |

要切換 Agent?你的 Skill 可能已經在那裡了
從 Claude Code 換到 Cursor
Cursor 也會讀取 ~/.claude/skills/ 和 ~/.codex/skills/,所以你為 Claude Code 安裝的 Skill 不用複製就會出現在 Cursor 中。要注意的是 Cursor 的命名規則:name 必須與資料夾名稱相同。一個在 Claude Code 中完全沒寫 name 也能正常執行的 Skill,在 Cursor 中可能會被略過。
依你希望 Skill 能被哪些 Agent 使用來選擇資料夾:
| 把 Skill 放在 | 可用於 |
|---|---|
~/.claude/skills/ | Claude Code 和 Cursor |
~/.agents/skills/ | Codex 和 Cursor |
~/.cursor/skills/ | Cursor,同步後也包括 Cloud Agents |
在雲端、網頁版和團隊中使用 Skill
放在個人資料夾中的 Skill 只存在於你的電腦上。除非你把它放到它們能存取的地方,否則雲端工作階段、網頁應用程式和同事都看不到它。
| Agent | 你的個人 Skill 無法觸及 | 該怎麼做 |
|---|---|---|
| Claude Code | 雲端工作階段、routines 和 Cowork | 在你的 claude.ai 帳號中啟用該 Skill;雲端工作階段也會載入 commit 到 .claude/skills/ 的 Skill |
| Codex | 網頁版和行動版 ChatGPT | 獨立的 Skill 可在 ChatGPT 桌面版、CLI 和 IDE 擴充功能中使用;網頁版和行動版則需透過 plugin 發布 |
| Cursor | Cloud Agents(除非已同步) | 把它放在 ~/.cursor/skills/,並開啟 Sync Skills for Cloud Agents |
在各 Agent 中安裝 Skillry 的 Skill
三個 Agent 的安裝指令都一樣,只有一個差別。
| Agent | 指令 |
|---|---|
| Claude Code | npx --yes skillry-cli@latest install <slug> --agent claude-code |
| Codex、Cursor | npx --yes skillry-cli@latest install <slug> |
CLI 的預設資料夾 ~/.agents/skills/ 是 Codex 和 Cursor 共用的,所以只有 Claude Code 需要額外的參數。Claude Code、Codex 和 Cursor 指南也介紹了安裝提示詞和 ZIP 的安裝方式。
常見問題
Cursor 能使用 Claude Skills 嗎?
可以。為了相容性,Cursor 會載入 ~/.claude/skills/ 和 .claude/skills/,只要每個 Skill 的 name 與資料夾名稱相同即可。
可以在 Codex 中使用 Claude Code 的 Skill 嗎?
可以,只要它的 SKILL.md 同時有 Codex 要求的 name 和 description。把資料夾從 ~/.claude/skills/ 複製到 ~/.agents/skills/,或不加 --agent claude-code 從 Skillry 重新安裝一次。
哪個 Agent 最適合用 Skill?
三者讀取的格式相同,所以用你平常工作的那個 Agent 就好。這一頁列出的差異,只有在你切換 Agent 或與團隊共用 Skill 時才重要。
Codex Skill 能在網頁版 ChatGPT 中使用嗎?
獨立的 Skill 不行。它們可以在 ChatGPT 桌面版、Codex CLI 和 IDE 擴充功能中使用。打包在 plugin 中的 Skill 則可以在網頁版、桌面版和行動版 ChatGPT 中使用。
參考來源
這篇指南對你有幫助嗎?
