什麼是 Agent Skills？Claude Skills 與 SKILL.md 完整解說

簡短回答

Skill 就是一個裡面有 SKILL.md 檔案的資料夾。檔案開頭是一段簡短的標頭，包含 name 和 description，後面接著指示內容。在請求對上之前，Agent 只會記住名稱和描述，對上之後才讀取其餘內容。同一個資料夾在 Claude Code、Codex 和 Cursor 中都能用。

跳到：看一個實際範例 SKILL.md 裡有什麼 Agent 如何挑選

為什麼需要 Skill

你大概也這樣做過

你存了一段 40 行的提示詞專門用來做產品發表頁，裡面寫清楚了版面、區塊，以及手機寬度下要檢查的項目。每次都貼一次，某次漏了一行，做出來的頁面就不一樣了。後來同事跟你要「那段提示詞」，你傳給他的是上個月的版本。

Skill 把那段提示詞變成一個 Agent 會自己找到的資料夾。以 Meridian Marketing Landing 為例：安裝之後，Agent 就已經知道方格紙風格的 Hero、功能格狀區塊和價格切換開關該怎麼做。你只需要提供產品資訊，其他什麼都不用。

大多數 Claude Skills 範例都是同一個模式：把產出某一類東西的方法固定下來。Notion Style OG Image 專門製作 16:9 的分享圖，Skillry 上還有製作簡報、履歷網站和短影片的 Skill。

	貼上的提示詞	Skill
你要說明的內容	每次都要交代版面、區塊、風格和檢查項目	只有你的內容
每次執行之間	每次都會有點偏差	照同樣的步驟執行
分享	要從對話紀錄裡翻出來	安裝同一個資料夾

SKILL.md 檔案裡有什麼？

Skill 只需要一個檔案 SKILL.md，另外可以附帶參考文件、腳本和範本等選用資料夾。這個檔案分成兩部分：--- 之間的簡短標頭，接著是寫給 Agent 看的純文字指示。

Skill 資料夾

launch-page/
├── SKILL.md        required
├── references/     optional: docs read when needed
├── scripts/        optional: code the agent can run
└── assets/         optional: templates and files

SKILL.md

---
name: launch-page
description: Build a product launch page with a hero, a feature
  grid, and a pricing toggle. Use when asked for a launch page.
---

1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.

name

最多 64 個字元，只能用小寫字母、數字和連字號，而且必須與資料夾名稱相同。

description

最多 1,024 個字元。寫出這個 Skill 做什麼，以及何時該用它；Agent 就是靠後半段來挑選它。

選填

license、compatibility、metadata、allowed-tools

這些限制來自開放的 Agent Skills 規格。Claude Code 比較寬鬆：可以省略 name，它會改用資料夾名稱。

Agent 如何決定要用哪個 Skill？

它會拿你的請求和每個 Skill 的描述比對。為了節省資源，每個 Skill 都分三個階段載入：

1啟動時，讀取每個已安裝 Skill 的名稱和描述，其他什麼都不讀。
2當你的請求符合某個描述，或你用名稱呼叫該 Skill 時，才載入完整的 SKILL.md。
3執行過程中，只有在指示要求時，才會開啟 references/ 裡的檔案或執行 scripts/。

這就是為什麼裝了幾十個 Skill 也不會拖慢 Agent。在需要用到之前，每個 Skill 大約只占一句話的 context。

Agent	用名稱呼叫 Skill
Claude Code	`/skill-name`
Codex	`$skill-name`，或從 `/skills` 中選取
Cursor	`/skill-name`，或用 `@skill-name` 附加

自動挑選的效果取決於描述寫得好不好。觸發機制會教你怎麼寫出會被選中的描述。在那之前，用名稱呼叫一定有效。

哪些 Agent 可以使用 Skill？

你聽過的大多數 Agent 都可以。Anthropic 為 Claude 設計了這個格式，並在 2025 年 12 月 18 日以開放標準發布。agentskills.io 網站目前列出了數十個支援的工具，包括 Claude Code、ChatGPT 與 Codex、Cursor、VS Code、GitHub Copilot 以及 Gemini CLI。

Agent	個人資料夾
Claude Code	`~/.claude/skills/`
Codex	`~/.agents/skills/`（也會讀取舊版的 `~/.codex/skills/`）
Cursor	`~/.cursor/skills/` 或 `~/.agents/skills/`

放在個人資料夾的 Skill，在你電腦上的每個專案中都能使用。專案資料夾以及 Agent 會搜尋的其他所有位置，都列在 Skill 存放位置。

Skill 還是提示詞：該用哪一個？

如果這件工作你會重複做，而且希望每次品質一致，就做成 Skill。只做一次的話，提示詞就夠了。

做成 Skill

你還會再做這件事

需要範例、腳本或檢查清單
你希望每次結果都一樣
其他人也需要用

用提示詞就好

只做一次

幾句話就說得清楚
你還在摸索自己想要什麼
裡面沒有值得重複使用的東西

大多數時候兩者會一起用。提示詞說明你今天要什麼，Skill 說明怎麼把它做好。Skill 與提示詞有更深入的說明。

安裝 Skill 前該檢查什麼

Skill 可以在你的電腦上執行腳本，所以每個新的 Skill 都要先快速看過一遍。

五分鐘檢查

閱讀 SKILL.md，留意它被允許修改哪些東西。
閱讀 scripts/ 裡的所有內容。這些腳本會在你的電腦上執行。
在 Skill 頁面上查看相依項目和外部費用。
不要把密碼和 API key 放進 Skill 檔案或對話裡。

完整清單請見安全性。準備好試試看時，快速上手會帶你完成第一次安裝。

常見問題

什麼是 Claude Skills？

這是多數人在 Claude 或 Claude Code 中使用 Agent Skills 時的稱呼。格式完全相同：一個含有 SKILL.md 檔案的資料夾。同一個資料夾在 Codex 和 Cursor 中也能使用。

Claude 怎麼知道該用哪個 Skill？

它會拿你的請求和每個 Skill 的描述比對，載入最合適的那一個。輸入 /skill-name 就不用讓它猜。

可以免費使用 Claude Skills 嗎？

Skill 只是一些檔案，所以免費的 Skill 不用花錢。不過你仍需要一個支援 Skill 的 Agent，例如 Claude Code、Codex 或 Cursor，並使用該產品要求的方案。Skillry 上也有免費的 Skill，例如 Dot Avatar Maker。

Skill 和 MCP server 一樣嗎？

不一樣。Skill 教 Agent 一套做法，MCP server 則讓它連上外部資料和工具。兩者經常一起使用。請見 Skill 與 MCP。

參考來源

這篇指南對你有幫助嗎？

下一篇快速上手