Claude Skills 存放在哪裡？各 Agent 的 Skill 資料夾

簡短回答

1Claude Code：~/.claude/skills/<name>/SKILL.md，專案中則是 .claude/skills/
2Codex：~/.agents/skills/，repo 中則是 .agents/skills/；仍會讀取舊版的 ~/.codex/skills/
3Cursor：~/.cursor/skills/ 或 ~/.agents/skills/，加上專案資料夾以及 Claude Code 和 Codex 的資料夾

Claude Code、Codex 與 Cursor 的 Skills 資料夾位置

每個 Agent 在你的家目錄裡都有一個個人資料夾，在 repo 裡有一個專案資料夾。有些還會讀取其他 Agent 的資料夾，所以同一份 Skill 可能會出現在不只一個工具裡。

Agent	個人	專案	也會讀取
Claude Code	`~/.claude/skills/`	`.claude/skills/`，以及 Claude 在子資料夾工作時，那些子資料夾中的 Skill	Enterprise 管理設定、plugin、你的 claude.ai 帳號（同步到 `~/.claude/skills/synced/`）
Codex	`~/.agents/skills/`	`.agents/skills/`，從你啟動的資料夾一路往上到 repo 根目錄	`~/.codex/skills/`（舊版）、`/etc/codex/skills/`、系統 Skill
Cursor	`~/.cursor/skills/`、`~/.agents/skills/`	`.cursor/skills/`、`.agents/skills/`，repo 中任何位置	`.claude/skills/`、`.codex/skills/`，以及 `~` 底下的這兩個

在 Windows 上，~ 是你的使用者資料夾，例如 C:\Users\you\.claude\skills。

Claude Code 的 Skills 資料夾應該長什麼樣子

每個 Skill 有自己的資料夾，SKILL.md 直接放在裡面。輔助檔案放在旁邊的子資料夾中。

所有 Agent 都看得懂的結構

~/.claude/skills/
└── launch-page/
    ├── SKILL.md
    ├── references/
    └── scripts/

ZIP 陷阱

解壓縮常會多出一層，結果變成 launch-page/launch-page/SKILL.md。Claude Code 只看 skills/<name>/SKILL.md，所以不會列出這個 Skill。Cursor 和 Codex 會往更深處找，可能還是找得到，這就是「在 Cursor 可以用，在 Claude Code 卻不見了」的原因。把內層資料夾往上移一層，各處就都能用了。

兩個 Skill 同名時，哪一份優先

只有 Claude Code 的文件寫明了順序。Codex 可能兩份都列出，Cursor 則沒有說明。

Agent	同名 Skill 放在兩個位置
Claude Code	先 Enterprise，其次個人，最後專案。Plugin Skill 帶有 plugin 名稱，所以永遠不會撞名。
Codex	不會合併；兩份都可能出現。
Cursor	文件未針對 Skill 說明。

別依賴這個順序。只保留一份，或把其中一個改名。

Cursor Cloud Agents 中的 Skill

只有 ~/.cursor/skills/ 會同步到 Cursor Cloud Agents，而且必須開啟 Sync Skills for Cloud Agents。放在 ~/.agents/skills/ 的 Skill 可能在你的電腦上能用，在雲端卻找不到。

搬移 Skill 之後

大多數時候 Agent 會自己察覺。如果 Skill 還是沒有出現，請這樣做：

Agent	讓變更生效
Claude Code	不用做什麼；如果是新的 Skills 資料夾，執行 `/reload-skills`
Codex	通常不用做什麼；沒出現就重新啟動
Cursor	開新對話或重新載入視窗

常見問題