說明
Claude Skills 是什麼
技能就是裝著 SKILL.md 的資料夾:frontmatter 決定「做什麼、什麼時候用」,正文寫具體步驟。本文講清楚檔案結構、載入條件、安裝與寫法。
一句話定義
技能就是一個裝著 SKILL.md 的資料夾。檔案分兩部分:
---
name: pdf
description: 讀取、拆分、合併並填寫 PDF。當任務涉及 PDF 時使用。
---
# PDF
代理要執行的步驟、檢查項目與範例…
- frontmatter(
name/description)是中介資料,description就是觸發條件。 - 正文是流程:做什麼、依什麼順序、檢查什麼。
- 需要時可以放腳本與素材,在正文以相對路徑呼叫。
Claude Code、Codex、Cursor 等代理會在需要時才載入技能,這正是描述必須寫準的原因。
代理怎麼決定載入
代理拿你的請求去比對 description。詞彙對上就載入,對不上就留在磁碟上。
失敗通常只有兩種:
- 描述太模糊(「一個對文件有幫助的技能」)→ 永遠比對不到。
- 描述精準,但隔壁技能更符合 → 載入了別的技能。
所以裝完先讀描述,再用它的詞彙提出需求。
放在哪裡
| 範圍 | 路徑 | 用途 |
|---|---|---|
| 個人 | ~/.claude/skills/<name>/SKILL.md |
所有專案通用 |
| 專案 | <project>/.claude/skills/<name>/SKILL.md |
只在這個倉庫用 |
其他代理有自己的技能目錄,CLI 會寫到對應位置。
安裝
npx skills add <owner>/<repo> --skill <name>
例如 npx skills add anthropics/skills --skill pdf。要指定代理就加 -a claude-code(或 -a cursor、-a codex)。詳見安裝指南。
自己寫一個
- 只做一件事。 一個技能做三件事,三件都不會被觸發。
- 寫 frontmatter。
name用短橫線命名,description寫清「做什麼 + 什麼時候用」。 - 正文寫成流程。 順序、檢查項目、一個實例,不要寫宣傳語。
- 需要才加腳本,並用相對技能目錄的路徑引用。
- 測觸發。 一個該觸發的請求、一個不該觸發的請求;誤觸發就先改描述。
發布前可以用SKILL.md 驗證器檢查結構。
技能 / MCP / 子代理
| 機制 | 給代理什麼 | 何時載入 |
|---|---|---|
| 技能 | 方法(步驟與檢查項目) | 描述符合時 |
| MCP 服務 | 連接(工具與資料) | 工作階段開始時 |
| 子代理 | 隔離(獨立上下文) | 被委派時 |
| 斜線指令 | 你主動呼叫的提示詞 | 輸入時 |
需要「存取」用 MCP,需要「方法」寫技能。
Next
Keep reading
Community notes
Found a broken install? Know a skill we missed?
One line is enough: the skill name, what happened, and the command you ran. We read every note and fix the index.