SKILL.mdファイルは、すべてのClaude Skillの中心です。短いYAMLヘッダー（nameとdescription）で始まるMarkdownファイルで、その後にClaudeが従うべき指示が続きます。説明はClaudeにSkillをいつ使うかを伝え、本文は使い方を伝えます。
このページ
そのtermを見たことはあるものの、実際に何が含まれているのか疑問に思ったことがあるなら、これは SKILL.md、なぜ各部分が重要なのか、そして実際に機能するものを書く方法。
SKILL.mdとは
Claude Skillはフォルダーであり、SKILL.mdはそのルートに置く必須ファイルです。通常のMarkdownなので、どのテキストエディターでも開けます。Claudeはこれを読み込み、ある種のタスクに必要な能力、つまり手順、ルール、ベストプラクティスを学習します。テンプレート、スクリプト、参照ファイルなどの追加ファイルは同じフォルダー内に置けますが、すべてのSkillに必須なのはSKILL.mdという1つのファイルです。
ゼロから作成するのではなく、適切な範囲に定められたSKILL.mdを見てみませんか？Yuriのフロントマターと指示はすでに作成・テストされており、レビューでバグ、セキュリティホール、パフォーマンス上の問題を見つけられるようになっています。
Yuri - コードレビュアーAI Skillを見る →SKILL.mdの2つの部分
1. フロントマター（メタデータ）
最上部には、---マーカーで囲まれた小さなYAMLブロックがあります。そこには重要なメタデータが含まれます。最低限、nameとdescriptionが必要です。
---
name: weekly-report
description: 生のメモを標準的な週次レポートに整えます。ユーザーが週次更新、ステータスレポート、または「今週の内容をまとめて」と依頼した場合に使用します。
---このブロックは特別です。セッションが始まると、ClaudeはインストールされているすべてのSkillについて、名前と説明だけを事前に読み込みます。ファイル全体ではありません。これによりコンテキストウィンドウを軽く保てるため、説明が大きな役割を果たします。
2. 本文（指示）
フロントマターの下に、通常のMarkdownでClaudeが実際に行うべきことを書きます。理想的には、必要なルールや例を含む、明確な番号付きの手順にします。
## 手順
1. メモを「成功」「進行中」「ブロッカー」の下にまとめます。
2. 各箇条書きは過去形の1文にする。
3. 1行の「次週」まとめで締めくくる。
4. メモにない指標を決して捏造しない。説明が最も重要な行である理由
トリガーは完全に説明次第です。作業中、Claudeはリクエストを各スキルの説明と照合し、一致した場合にのみ完全なファイルを読み込みます。曖昧な説明（「レポートを支援する」など）では、ほとんど実行されません。具体的な説明（「ユーザーが週次更新や進捗レポートを求めたときに使用する」など）なら、確実に実行されます。1つだけルールを覚えるなら、これです。スキルの内容だけでなく、スキルをいつ使うかを説明に書く。
Claudeがファイルを使用する方法
- 起動時:Claudeはすべてのスキルの名前と説明を読み取ります。
-
タスク中:リクエストが説明に一致すると、Claudeはそのスキルの完全な
SKILL.md（および添付リソース）を読み込みます。 - その後:Claudeが本文の指示に従って作業を完了します。
この「必要なときだけ読み込む」アプローチは段階的開示と呼ばれ、多数のスキルをインストールしてもモデルのコンテキストを肥大化させずに済む仕組みです。
優れたSKILL.mdを書く
- 説明を完璧にする。スキルを実行すべきタイミングを明確に記載する。
- 最初のバージョンは小さく保つ。明確な手順を5〜10行にまとめたほうが、長大なドキュメントより優れています。
- 具体的にする。番号付きの手順、明確なルール、短い例を用意する。
- 実際のタスクでテストする。Claudeが対応できない部分だけ拡張する。
自分で作成する必要がありますか？
いいえ。自分専用のワークフローなら自作するのが最適ですが、結果だけが欲しい場合は、既製のスキルに作成・テスト済みのSKILL.mdが付属しています。1,000種類以上のスキル、promptパック、エージェントを揃えたKissMySkillsライブラリや、Claude Codeスキルコレクションをご覧ください。まず実際の動作を見てみたいですか？無料ジェネレーターを試すか、無料スキルを入手してください。
すべてのSKILL.mdがコーダー向けとは限りません - Ryanのfrontmatterと手順は、編集不要で取締役会資料、全社会議メモ、役員向けブリーフィングに使えるよう書かれています。
Ryan - Chief of Staff AI Skillを見る →よくある質問
SKILL.mdは単なるMarkdownですか？
はい - 上部にYAMLのfrontmatterブロックがある標準的なMarkdownファイルです。特別なソフトウェアは必要なく、どのテキストエディターでも開けます。
SKILL.mdに必要なものは何ですか？
最低限、名前と説明を含むfrontmatterブロックが必要です。手順を記述した本文がSkillを便利にしますが、メタデータによって発見・トリガーが可能になります。
SKILL.mdファイルはどこに置きますか？
Skillのフォルダーのルートに置きます。Claude Codeでは、Skillは次の場所にあります： ~/.claude/skills/<name>/ 個人利用の場合は、次の場所にあります： .claude/skills/<name>/ プロジェクト内では、次の場所にあります： SKILL.md フォルダーのルートにあります。
SKILL.mdの内容をChatGPTやGeminiで使えますか？
はい。手順は持ち運び可能です - 本文をChatGPTまたはGeminiのカスタム指示に貼り付ければ、同じ動作を実現できます。frontmatterによる自動トリガーはClaudeの機能です。
まとめ：
自分でYAMLのfrontmatterを書くのを省きたいなら、Yuri - Code Reviewerは開発者に最適です。また、Ryan - Chief of Staffは役員向けおよびビジネス向けの文章作成に対応します。どちらもコーディング不要で、Claude、ChatGPT、あらゆるAIチャットで利用でき、30日間の返金保証が付いています。
実際に動く例から始める
SKILL.mdを理解する最も早い方法は、優れたものを1つ読むことです。無料のSkillを入手してファイルを開き、frontmatterと手順で構成された構造を実際に確認してみましょう。その後、3分で読めるインストール方法をご覧ください。