Claude Code Skills 速查表（含 Codex 與 Cursor）

簡短回答

1資料夾：~/.claude/skills · ~/.agents/skills（以及舊版 ~/.codex/skills）· ~/.cursor/skills
2執行：/name（Claude Code、Cursor）· $name（Codex）· 在 Cursor 中用 @name 附加
3查看已安裝項目：/skills · Customize → Skills
4安裝：npx --yes skillry-cli@latest install <slug>，Claude Code 需加上 --agent claude-code

各 Agent 的 Skills 資料夾

個人 Skill 在你開啟的每個專案中都能用。專案 Skill 放在 repo 裡，所有 clone 這個 repo 的人都會拿到。

Agent	個人	專案
Claude Code	`~/.claude/skills/`	`.claude/skills/`
Codex	`~/.agents/skills/`（舊版：`~/.codex/skills/`）	`.agents/skills/`，從你啟動的資料夾一路往上到 repo 根目錄
Cursor	`~/.cursor/skills/`、`~/.agents/skills/`	`.cursor/skills/`、`.agents/skills/`

各 Agent 會讀取的所有資料夾，以及同名時哪一份優先：Skill 存放位置。

用名稱呼叫 Skill 是確認它是否安裝成功最快的方法。能執行，就代表 Agent 看得到它。

操作	Claude Code	Codex	Cursor
列出 Skill	`/skills`	`/skills`	Customize → Skills
執行	`/name`	`$name`	`/name`、`@name`
Plugin Skill	`/plugin:name`	透過 plugin	透過 plugin
保持啟用	—	—	Option/Alt+Enter（Custom Mode）
修改之後	即時生效；新資料夾需執行 `/reload-skills`	即時生效；沒生效就重新啟動	開新對話或重新載入視窗

每個 Skill 都有一個 SKILL.md 檔案，它的設定放在檔案最上方兩條 --- 之間。以下這些欄位會影響 Agent 如何對待它。

欄位	限制／作用	Claude Code	Codex	Cursor
`name`	≤64 個字元；a–z、0–9 與連字號；與資料夾名稱相同	選填	必填	必填
`description`	≤1,024 個字元；說明它做什麼、何時使用	建議填寫	必填	必填
`allowed-tools`	不必詢問就能使用的工具（規格中屬實驗性質）	支援	—	—
`paths`	只在符合的檔案模式下才會自動執行	支援	—	支援

Skillry CLI 會從 Skillry 下載 Skill，並放進你的 Agent 對應的資料夾。

指令	作用
`skillry-cli login`	透過瀏覽器以裝置代碼登入
`skillry-cli status`	顯示你目前登入的帳號
`skillry-cli install <slug>`	安裝到 `~/.agents/skills/<slug>/`
`--agent claude-code`	…改為安裝到 `~/.claude/skills/<slug>/`
`--target <dir>`	…安裝到任一 Skills 資料夾，例如 `.claude/skills`
`--force`	取代現有的那份並保留備份
`skillry-cli logout`	登出並撤銷工作階段

每個指令都以 npx --yes skillry-cli@latest 開頭。可在 macOS 或 Windows 上搭配 Node.js 22 以上版本執行。--agent 和 --target 不能同時使用。

/skills 列出你的 Skill，/skill-name 執行某個 Skill，/plugin-name:skill-name 執行隨 plugin 附帶的 Skill，/reload-skills 則會讀取你剛建立的 Skills 資料夾。

比較各 Agent 用實際範例說明了相同的內容。

這篇指南對你有幫助嗎？