簡短回答
- 1把 Skill 的資料夾放在
~/.claude/skills/就能在每個專案中使用，放在.claude/skills/則只限於單一 repository。 - 2用 Skillry CLI 安裝？請加上
--agent claude-code。不加的話，Skill 會裝到~/.agents/skills/，而 Claude Code 不會讀取那裡。 - 3輸入
/skills確認它在清單中，再輸入/skill-name加上你的需求來執行它。 - 4想要現成的？瀏覽一個指令就能安裝的 Claude Code Skills。
如何把 Skill 加到 Claude Code
你可以把安裝提示詞貼到 Claude Code、自己執行 Skillry CLI，或手動把資料夾複製進去。每種方式的結果都一樣：Skill 的資料夾位於 ~/.claude/skills/ 中。
大家最常漏掉的參數
Skillry CLI 預設安裝到 ~/.agents/skills/，因為 Codex 和 Cursor 都會讀取這個資料夾。Claude Code 讀取的是自己的 ~/.claude/skills/。漏了 --agent claude-code，安裝依然會回報成功，但 Claude Code 永遠看不到這個 Skill。
- 1
在 Skillry 上打開這個 Skill，點選複製安裝提示詞，再點對話框中的複製。
- 2
貼到 Claude Code 中送出。Agent 會讀取 Skillry 的安裝說明，並自行執行正確的指令。
安裝提示詞 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
瀏覽器要求你核准裝置代碼時，按下核准。
你應該會看到： Claude Code 回報它安裝的版本，以及它使用的資料夾（位於
~/.claude/skills/底下）。
- 1
登入一次。瀏覽器會開啟視窗，顯示一組讓你核准的裝置代碼。
終端機 npx --yes skillry-cli@latest login - 2
安裝，並在最後加上
--agent claude-code。終端機 npx --yes skillry-cli@latest install <slug> --agent claude-code你應該會看到：
Installed <slug> <version> to ~/.claude/skills/<slug>
在 Skill 頁面點選下載 ZIP，或使用你從別處取得的 Skill 資料夾。安裝前先閱讀 SKILL.md 和 scripts/ 裡的所有內容，因為 Agent 會照著那些指示做，也可能執行那些腳本。然後移動整個資料夾：
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/ZIP 解壓後常會多出一層，例如 my-skill/my-skill/SKILL.md。SKILL.md 必須直接位於 Skill 的資料夾內，否則 Agent 會找不到它。
確認 Claude Code 看得到它
輸入 /skills。清單會顯示你自己的 Skill，以及 Claude Code 內建的幾個，例如 /code-review。按 t 可以依各自占用的 context 大小排序。
不需要重新啟動。Claude Code 會在目前的工作階段中讀到新增和修改過的 Skill。唯一的例外：如果工作階段開始時 ~/.claude/skills/ 還不存在，請執行一次 /reload-skills。
把 Skill 當成 Claude Code 的 slash command 執行
你安裝的每個 Skill 都會以它的名稱出現為一個 slash command。輸入這個指令，然後在同一行寫下你要什麼：
/launch-page Parcelo, a parcel-tracking dashboard for small online shops名稱後面的所有內容都會以 $ARGUMENTS 的形式傳給 Skill。確認它能運作之後，通常就可以省略指令，直接用一般說法描述任務。當你的請求符合 Skill 的描述時，Claude 會自動載入它。如何使用 Skill 有更多拿到好結果的技巧。
Claude Code 會到哪裡找 Skill，以及哪一份優先
Claude Code 會從五個地方收集 Skill。多數人只會用到個人和專案資料夾；其他的則在團隊協作或安裝 plugin 時才會用到。
| 來源 | 位置 | 指令 |
|---|---|---|
| Enterprise | 管理設定 | /skill-name |
| 個人 | ~/.claude/skills/<name>/ | /skill-name |
| 專案 | .claude/skills/<name>/ | /skill-name |
| Plugin | <plugin>/skills/<name>/ | /plugin-name:skill-name |
| 你的 claude.ai 帳號 | 同步到 ~/.claude/skills/synced/ | /name 或 /anthropic-skills:name |
同一個名稱出現在兩個地方時，Enterprise 優先於個人，個人優先於專案。子資料夾的 .claude/skills/ 中的 Skill，會在 Claude 第一次處理該子資料夾的檔案時載入，所以大型 repo 中只針對某個套件的 Skill，在你需要之前都不會礙事。
控制執行時機的 SKILL.md 設定
這些欄位放在 SKILL.md 最上方的 frontmatter 中。只有當 Skill 執行得太頻繁、不夠頻繁，或每一步都停下來請求權限時，才需要用到它們。
| SKILL.md 中的欄位 | 作用 |
|---|---|
description | Claude 會讀它來決定是否使用這個 Skill。它和 when_to_use 合計在 Skill 清單中最多保留 1,536 個字元，超過就截斷。 |
allowed-tools | 在呼叫該 Skill 的那一輪中，Claude 不必詢問就能使用的工具。 |
paths | 檔案模式。只有在處理符合的檔案時，Claude 才會自動載入這個 Skill。 |
Claude Code Skill 無法正常運作？先檢查這些
從上往下檢查。第一列「Skill 放錯資料夾」是最常見的原因。
/skills 裡沒有它
資料夾放錯了，或 ZIP 多出一層。把它移到路徑為 ~/.claude/skills/<name>/SKILL.md 的位置，或用 --agent claude-code 重新安裝。
資料夾是剛建立的
執行 /reload-skills。
在雲端工作階段中找不到
把它 commit 到 repo 的 .claude/skills/，或在 claude.ai 上啟用它。
在 Cowork 中找不到
在你的 claude.ai 帳號中啟用它。
有列出但從未被選中
用 /name 呼叫，確認它能運作，再把描述寫得更具體。請見觸發機制。
其他狀況請見疑難排解。
常見問題
Claude Code 支援 Skill 嗎？
支援。Claude Code 遵循開放的 Agent Skills 標準，會從你的個人資料夾、目前的專案、plugin、你的組織以及你的 claude.ai 帳號載入 Skill。
Claude Code 的 Skill 存放在哪裡？
你自己的 Skill 放在 ~/.claude/skills/<name>/SKILL.md。只用於單一專案的 Skill 放在該 repository 內的 .claude/skills/<name>/SKILL.md。
自訂 slash command 怎麼了？
它們依然可以使用。.claude/commands/deploy.md 檔案和名為 deploy 的 Skill 都會提供 /deploy。兩者同時存在時，以 Skill 為準。
為什麼 Skillry CLI 需要 --agent claude-code？
它的預設資料夾是 Codex 和 Cursor 共用的 ~/.agents/skills/。Claude Code 讀取的是 ~/.claude/skills/，這個參數會把安裝位置指向那裡。
參考來源
這篇指南對你有幫助嗎？