SKILL.mdとは、Skillの実体であるMarkdownファイル。冒頭のフロントマター（---で挟んだ部分）に名前と説明を、本文に手順を記述する。
記述例
---
name: article-draft
description: 構成案の壁打ちから初稿生成までを支援する
---
## 手順
1. 想定読者と検索意図を確認する
2. 構成案を3パターン提示する
3. 採用された案から初稿を生成する解説
ファイルはSkillごとのフォルダに置く。プロジェクト単位なら.claude/skills/[Skill名]/SKILL.md、ユーザー全体で使うなら~/.claude/skills/配下に配置する。同じフォルダに参考資料やスクリプトを同梱でき、AIは必要なときだけそれらを読み込む。
descriptionはAIがSkillを使うかどうか判断する材料になるため、何をするSkillかを具体的に書くことが重要になる。
段階的に読み込まれる仕組み
SKILL.mdは全体が常に読み込まれているわけではない。公式仕様では3段階の読み込み方が定義されている。まずnameとdescriptionだけが起動時に全Skill分（1件あたり目安約100トークン）読み込まれ、そのSkillを使うと判断されたときに本文全体が読み込まれ、さらにscripts/やreferences/配下のファイルは実際に必要になったときだけ読み込まれる。この段階構造があるため、公式ガイドラインではSKILL.md本文を推奨5,000トークン未満・500行未満に収め、詳細な参考資料は別ファイルに分けることが勧められている。