Claude Code Skills · SKILL.md 解剖
一個 SKILL.md 長什麼樣？五個區塊拆給你看
skill 不是一個 markdown 檔，是一個資料夾。以一個「週報產生器」為例，把 SKILL.md 的五個區塊各自在做什麼拆開看。
資料來源：Anthropic《Lessons from building Claude Code》
|
製作：《數位時代》
SKILL.md
name: weekly-report
name（代號）
skill 的名字，讓你和模型都能指名呼叫它。
description: 彙整這週完成的工作，
產生給主管看的週報。當使用者說
「跑週報」「整理這週進度」時觸發。
description（觸發說明）
寫給模型看的，不是給人的摘要。講清楚「什麼情況該用我」，並把觸發詞直接寫進去。
## 怎麼做
1. 讀 config.json 取得寄給誰、
用什麼格式；沒設定就先問。
2. 只列「跟上週相比的新進度」。
3. 存進 reports.log，下次讀歷史。
怎麼做（主要指令）
給 Claude 方向，但別把每一步講死，留點彈性讓它隨狀況調整。
## Gotchas（踩過的坑）
- 「標記完成」不等於真的結案，
狀態要看最新那一版。
- 同一件事改過好幾次，
只取最後定案的版本。
Gotchas（踩過的坑）
整份 skill 訊號最高的區塊。把「文件不會寫、被坑過才知道」的細節都累積在這。
## 參考
- 欄位與格式範本見
references/format.md（需要時再讀）。
參考（漸進揭露）
把細節拆到別的檔案，需要時 Claude 才去讀，不必一開始就全部載入。
把這五塊湊齊，就是一個能用的 skill。Anthropic 的建議是：先做小的，撞到坑就補一條 Gotcha，比一開始追求完整更有效。