簡短回答
- 1把 Skill 放在
~/.cursor/skills/就能在每個專案中使用（這也是唯一能同步到 Cloud Agents 的資料夾），放在.cursor/skills/則只限於單一專案。 - 2
SKILL.md中的name必須與資料夾名稱相同，而且只能使用小寫字母、數字和連字號。 - 3在 Customize → Skills 中找到它。用
/skill-name執行，或用@skill-name附加到訊息上。 - 4想要現成的？瀏覽一個指令就能安裝的 Cursor Skills。
Cursor 會到哪裡找 Skill
Cursor 會檢查自己的資料夾、共用的 ~/.agents/skills/，以及 Claude Code 和 Codex 的資料夾。如果你已經在用其他 Agent，你的 Skill 可能早就出現在 Cursor 裡了。
| 資料夾 | 用途 |
|---|---|
~/.cursor/skills/ | 所有專案。唯一會同步到 Cloud Agents 的資料夾。 |
~/.agents/skills/ | 這台電腦上的所有專案。Skillry 安裝在這裡，Codex 也會讀取。 |
.cursor/skills/ 或 .agents/skills/ | 單一專案，可放在 repo 中任何位置。巢狀資料夾會套用到它底下的檔案。 |
.claude/skills/、.codex/skills/，以及 ~ 底下的同名資料夾 | 會讀取這些資料夾，讓 Claude Code 和 Codex 的 Skill 在這裡也能用。 |
如何把 Skill 加到 Cursor
Skillry CLI 會安裝到 Cursor 會讀取的 ~/.agents/skills/，所以不需要加參數。如果你是手動複製資料夾，請改放在 ~/.cursor/skills/；這個資料夾才能跟著你到 Cloud Agents。
- 1
在 Skillry 上打開這個 Skill，點選複製安裝提示詞，再點對話框中的複製。
- 2
貼到 Cursor 中送出。Agent 會讀取 Skillry 的安裝說明，並自行執行正確的指令。
安裝提示詞 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
瀏覽器要求你核准裝置代碼時，按下核准。
你應該會看到： Cursor 回報它安裝的版本，以及它使用的資料夾（位於
~/.agents/skills/底下）。
- 1
登入一次。瀏覽器會開啟視窗，顯示一組讓你核准的裝置代碼。
終端機 npx --yes skillry-cli@latest login - 2
安裝。不需要加任何參數，因為 CLI 的預設資料夾就是 Cursor 會讀取的那個。
終端機 npx --yes skillry-cli@latest install <slug>你應該會看到：
Installed <slug> <version> to ~/.agents/skills/<slug>
在 Skill 頁面點選下載 ZIP，或使用你從別處取得的 Skill 資料夾。安裝前先閱讀 SKILL.md 和 scripts/ 裡的所有內容，因為 Agent 會照著那些指示做，也可能執行那些腳本。然後移動整個資料夾：
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/ZIP 解壓後常會多出一層，例如 my-skill/my-skill/SKILL.md。SKILL.md 必須直接位於 Skill 的資料夾內，否則 Agent 會找不到它。
Cursor 在啟動時搜尋 Skill。安裝後請開新對話或重新載入視窗，再到 Customize → Skills 的 Agent Decides 群組中確認。
讓 Skill 消失的命名規則
只有當 SKILL.md 中的 name 與所在資料夾名稱完全相同時，Cursor 才會載入該 Skill。兩者不一致時不會出現任何錯誤，Skill 就是不見了。
為什麼它不見了？
你下載了 launch-page，為了整齊把資料夾改名成 landing，結果它就從 Cursor 中消失了。資料夾和 name 不再一致。把資料夾名稱改回來，或把 name 改成 landing。
Cursor 接受的名稱
- 只能使用小寫字母、數字和連字號
- 與存放
SKILL.md的資料夾名稱完全相同 - 搭配一段
description
如何在 Cursor 中執行 Skill
在對話中輸入 / 和 Skill 的名稱，接著寫下你的需求：
/launch-page Parcelo, a parcel-tracking dashboard for small online shops若要讓某個 Skill 在整個工作階段都保持啟用，請從 / 選單中選取它，再按 Option+Enter（Mac）或 Alt+Enter（Windows），或選擇 Use as Mode。它會變成一個 Custom Mode，直到你離開為止都會保持啟用。
在 Cloud Agents 中使用 Skill
Cloud Agents 不在你的電腦上執行，所以只能拿到 Cursor 為它們同步的 Skill。設定方式如下：
- 1把 Skill 放在
~/.cursor/skills/。專案 Skill 和~/.agents/skills/只會留在你的電腦上。 - 2打開 Settings → Agents → Context and Tools，開啟 Sync Skills for Cloud Agents。
- 3若想改為與團隊共用個人 Skill，請在 Customize → Skills 中打開它，選擇 Publish。
Cursor rules 與 Skill 的差別
Cursor rules 是 Cursor 加進對話中的簡短指引，可以一律加入，或只針對符合的檔案。Skill 則是 Agent 只在任務需要時才載入的流程。慣例用 rules，多步驟工作用 Skill。
按需載入的流程
- 含有
SKILL.md的資料夾 - 相關時執行，或你輸入
/name時執行 - 多步驟工作、腳本、範本
Context 中的指引
.cursor/rules/中的.mdc檔案（一般的.md檔案會被忽略）- Always Apply、Apply Intelligently、Apply to Specific Files 或 Apply Manually
- 簡短的慣例。Cursor 也會讀取
AGENTS.md和CLAUDE.md
要把舊的 rules 搬過來？Cursor 內建的 /migrate-to-skills 會把「Apply Intelligently」規則和 slash command 轉換成 Skill。
Cursor Skill 沒有出現？試試這些
先檢查名稱。name 和資料夾不一致，是 Skill 在 Cursor 中消失最常見的原因。
Customize → Skills 裡沒有它
確認 name 與資料夾名稱相同，然後開新對話或重新載入視窗。
在 Cloud Agents 中找不到
把它移到 ~/.cursor/skills/ 並開啟同步。
從不自動被選中
它的描述可能不符合你的提問方式，或 paths 把它限制在其他檔案上。
常見問題
Cursor rules 和 Skill 有什麼不同？
Rules 是 Cursor 加進對話中的指引，可以一律加入，或只針對符合的檔案。Skill 是存放流程的資料夾，Agent 會在相關時或你呼叫時使用它。
Cursor 能使用 Claude Skills 嗎？
可以。Cursor 會讀取 ~/.claude/skills/ 和 .claude/skills/，只要每個 Skill 的 name 與資料夾名稱相同即可。
Cursor 的 Skill 存放在哪裡？
所有專案共用的放在 ~/.cursor/skills/ 或 ~/.agents/skills/，單一專案的放在 .cursor/skills/ 或 .agents/skills/。
Skill 能在 Cursor Cloud Agents 中使用嗎？
只有放在 ~/.cursor/skills/ 中的 Skill 可以，而且必須先開啟 Sync Skills for Cloud Agents。
參考來源
這篇指南對你有幫助嗎？
