簡短回答
- 1Agent 已經開著?用複製安裝提示詞。正在用終端機?用 CLI。從 GitHub 拿到資料夾?直接複製進去。
- 2Claude Code 需要加上
--agent claude-code。Codex 和 Cursor 使用預設資料夾~/.agents/skills/。 - 3當
SKILL.md直接位於 Skill 的資料夾內,而且 Agent 有列出它,就完成了。
該用哪種方式?
依你現在所在的環境決定。三種方式的結果都一樣:Skill 的資料夾放在 Agent 找得到的位置。
Agent 已經開著
在 Skill 頁面點選複製安裝提示詞,再貼到 Agent 中
你習慣用終端機
Skillry CLI(macOS 或 Windows,Node.js 22+)
你用的是 Linux,或想先看過檔案
下載 ZIP,再手動把資料夾複製進去
Skill 放在 GitHub 上
Clone 或下載該 repository,再手動把資料夾複製進去

各 Agent 會到哪裡找 Skill?
每個 Agent 都從自己的資料夾讀取 Skill,CLI 會幫你選好資料夾。Codex 和 Cursor 都會讀取 ~/.agents/skills/,所以裝一次兩者都能用。
| Agent | Skillry CLI | 安裝位置 |
|---|---|---|
| Claude Code | --agent claude-code | ~/.claude/skills/<slug>/ |
| Codex | 預設,不需參數 | ~/.agents/skills/<slug>/ |
| Cursor | 預設,不需參數 | ~/.agents/skills/<slug>/ |

如何把 Skill 加到 Claude Code、Codex 或 Cursor
打開你選擇的方式所對應的分頁。前兩種在完成時會回報版本和資料夾;手動複製的話,則需要自己檢查資料夾。
- 1
在 Skill 頁面點選複製安裝提示詞,再點對話框中的複製。
- 2
貼到 Agent 中。Agent 會讀取 Skillry 的安裝說明,並自行執行正確的指令。
安裝提示詞 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
出現提示時,在瀏覽器中核准裝置代碼。
你應該會看到: Agent 回報它安裝的版本和使用的資料夾。
- 1
登入一次。瀏覽器會開啟視窗,請你核准一組裝置代碼。
終端機 npx --yes skillry-cli@latest login - 2
安裝 Skill。如果是 Claude Code,請加上
--agent claude-code。終端機 npx --yes skillry-cli@latest install <slug>你應該會看到:
Installed <slug> <version> to ~/.agents/skills/<slug> - 3
之後要重新安裝?加上
--force。不加的話,CLI 會停下來,不會覆蓋你現有的那份。
Skillry 絕不會要你貼上 API key。你的登入資訊存放在 macOS 鑰匙圈或 Windows 認證管理員中。
要複製整個資料夾,不能只複製 SKILL.md。指示內容經常會引用放在它旁邊的檔案。
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/只有一層
~/.claude/skills/my-skill/SKILL.md
ZIP 多出了一層
~/.claude/skills/my-skill/my-skill/SKILL.md- 或
SKILL.md直接散落在skills/裡
如何只為單一專案安裝 Skill?
把 --target 指向專案的 Skills 資料夾。CLI 沒有獨立的專案參數,但 --target 接受任何 Skills 資料夾,所以請在 repository 內執行:
npx --yes skillry-cli@latest install <slug> --target .claude/skills把那個資料夾 commit 起來,每個 clone 這個 repository 的人都會拿到同一個 Skill。
--agent 和 --target 擇一使用,不能同時用。CLI 會拒絕這種組合。
如何確認安裝成功
趁現在花三十秒確認,別等到真正要用時才發現問題。
- 1打開資料夾,確認
SKILL.md就在裡面,而不是在下一層。 - 2列出你的 Skill:Claude Code 和 Codex 用
/skills,Cursor 用 Customize → Skills。 - 3用名稱執行一次。
清單裡沒有?疑難排解會逐一說明每種原因。
常見問題
怎麼用 npx 安裝 Skill?
執行 npx --yes skillry-cli@latest install <slug>,如果是 Claude Code 再加上 --agent claude-code。它會透過瀏覽器讓你登入,並顯示 Skill 安裝的位置。
怎麼從 GitHub 安裝 Claude Skills?
下載或 clone 該 repository,然後把 Skill 的資料夾(SKILL.md 直接位於其中)移到 ~/.claude/skills/ 或專案的 .claude/skills/。
可以在免費版 Claude 中加入 Skill 嗎?
在 Claude Code、Codex 和 Cursor 中,Skill 是你自己安裝的資料夾。至於能否在 claude.ai 應用程式中使用 Skill,則取決於你的 Claude 方案和設定。
參考來源
這篇指南對你有幫助嗎?
