SKILL.md 檔案是每個 Claude Skill 的核心 - 這是一個以簡短 YAML 標頭（name 和 description）開頭，後面接著 Claude 應遵循之指示的 Markdown 檔案。描述會告訴 Claude 何時使用此 Skill；內文則告訴它如何使用。
如果你看過 term，卻想知道其中實際包含什麼，以下是 SKILL.md、為什麼每個部分都很重要，以及如何撰寫一份能正常運作的檔案。
什麼是 SKILL.md
Claude Skill 是一個資料夾，而 SKILL.md 是其根目錄中必要的檔案。它是純 Markdown，因此可在任何文字編輯器中開啟。Claude 會讀取它，以學習某項能力 - 也就是某類任務的步驟、規則和最佳實務。選用的額外內容（範本、指令碼、參考檔案）可以與它放在同一個資料夾中，但 SKILL.md 是每個 Skill 都必須具備的唯一檔案。
想看看一份範圍界定完善的 SKILL.md，而不是從頭開始建立嗎？Yuri 的 frontmatter 和指示都已經撰寫並測試過，可在審查中找出錯誤、安全漏洞和效能問題。
查看 Yuri - Code Reviewer AI Skill →SKILL.md 的兩個部分
1. frontmatter（中繼資料）
最上方是一個位於 --- 標記之間的小型 YAML 區塊。它包含必要的中繼資料 - 至少包括 name 和 description：
---
name: weekly-report
description: 將原始筆記整理成我們標準的每週報告。當使用者要求每週更新、狀態報告，或要求「整理本週內容」時使用。
---這個區塊很特別：工作階段開始時，Claude 只會預先載入每個已安裝 Skill 的名稱和描述 - 而不是整個檔案。這能讓上下文視窗保持精簡，也正是描述內容能發揮如此重要作用的原因。
2. 內文（指示）
在 frontmatter 下方，以一般 Markdown 撰寫 Claude 實際應執行的內容 - 最理想的是清楚、編號的步驟，並附上任何規則或範例：
## 步驟
1. 將筆記分到「已完成」、「進行中」和「阻礙」之下。
2. 每個項目符號只寫一句話，使用過去式。
3. 以一行「下週」摘要作結。
4. 絕不捏造筆記中沒有的指標。為什麼描述是最重要的一行
觸發完全取決於描述。工作時，Claude 會將你的要求與每項技能的描述進行比對，只有在符合時才載入完整檔案。模糊的描述（「協助製作報告」）很少會觸發。具體的描述（「使用者要求每週更新或狀態報告時使用」）則能可靠觸發。如果你只記得一項規則，請記住這個：撰寫描述時，應說明何時使用這項技能，而不只是說明它是什麼。
Claude 如何使用檔案
- 啟動時：Claude 會讀取每項技能的名稱和描述。
-
執行任務期間：如果你的要求符合某項技能的描述，Claude 會載入該技能完整的
SKILL.md（以及任何附加資源）。 - 接著：Claude 會遵循本文的指示完成工作。
這種「只在需要時載入」的方法稱為漸進式揭露，讓你能安裝許多技能，同時不讓模型的上下文變得臃腫。
撰寫優質的 SKILL.md
- 精準撰寫描述。清楚說明技能應在何時觸發。
- 讓第一個版本保持精簡。五到十行清楚的步驟勝過一份冗長的文件。
- 具體明確。使用編號步驟、明確規則和一個簡短範例。
- 在實際任務上測試。只有在 Claude 遺漏內容時才擴充。
你必須自己撰寫一個嗎？
不用。為你專屬工作流程自行撰寫當然很好，但如果你只想要結果，現成技能已經附有製作完成並經過測試的 SKILL.md。瀏覽擁有 1,000 多項技能、prompt 套件和代理程式的 KissMySkills 資料庫，或查看 Claude Code 技能收藏。想先看看實際運作嗎？試用免費生成器，或取得免費技能。
並非每個 SKILL.md 都是給程式設計師使用的 - Ryan 的 frontmatter 和指示是為董事會資料包、全員會議備忘錄與高階主管簡報撰寫的，不需要編輯。
查看 Ryan - 幕僚長 AI Skill →常見問題
SKILL.md 只是 Markdown 嗎？
是 - 它是標準 Markdown 檔案，頂端包含 YAML frontmatter 區塊。可用任何文字編輯器開啟，不需要特殊軟體。
SKILL.md 需要哪些內容？
至少需要一個包含名稱與描述的 frontmatter 區塊。包含指示的本文才是 Skill 實用的原因，但中繼資料才是讓它可被發現並觸發的關鍵。
SKILL.md 檔案應放在哪裡？
位於 Skill 資料夾的根目錄。在 Claude Code 中，Skill 存放於 ~/.claude/skills/<name>/ 供個人使用，路徑為 .claude/skills/<name>/ 位於專案中，路徑為 SKILL.md 位於資料夾根目錄。
我可以在 ChatGPT 或 Gemini 中使用 SKILL.md 的內容嗎？
是。這些指示可以攜帶使用 - 將本文貼到 ChatGPT 或 Gemini 的自訂指示中，就能獲得相同的行為。透過 frontmatter 自動觸發則是 Claude 的功能。
總結：
如果你不想自己撰寫 YAML frontmatter，Yuri - 程式碼審查員 是開發人員的可靠選擇，而 Ryan - 幕僚長 則涵蓋高階主管與商務寫作。全部都能在 Claude、ChatGPT 和任何 AI 聊天工具中使用，不需寫程式，並提供 30 天退款保證。
從一個可運作的範例開始
理解 SKILL.md 最快的方法，就是閱讀一份優質範例。取得一個免費 Skill，開啟檔案，實際看看 frontmatter 加上步驟的結構 - 然後花三分鐘閱讀如何安裝。