Claudeスキルの書き方入門：発動率を上げるSKILL.md 5つの原則とひな形

2026年10月13日

Claudeのスキル(SKILL.md)は「書けば動く」ものではなく、descriptionの書き方ひとつで発動率が大きく変わります。公式ドキュメントと実践記事から、良いスキルに共通する5つの原則と、最小構成のひな形をまとめました。

スキルの基本構造をおさらい

Agent Skillsは、フォルダ内の SKILL.md と補助ファイルで構成される再利用可能な能力パッケージです。Claudeは段階的に読み込む(プログレッシブ・ディスクロージャー)ため、使われないスキルがコンテキストを圧迫しにくい設計になっています。

段階	読み込まれる内容	タイミング
Level 1	frontmatterの name / description	常時
Level 2	SKILL.md 本文	スキルが選ばれたとき
Level 3	補助ファイル・スクリプト	必要になったとき

必須項目は name(64文字以内、小文字・数字・ハイフンのみ)と description(1024文字以内)。descriptionには「何をするか」と「いつ使うか」の両方を入れる、と公式ドキュメントに明記されています。

良いスキルに共通する5つの原則

Firecrawlの解説記事では、優れたスキルの共通パターンとして次の点が挙げられています。

descriptionはルーティングルールとして書く — 発動すべき場面を具体的に。
決まった処理はスクリプトに任せる — 解析・検証・並べ替えを「注意深くやって」とモデルに頼まない。
SKILL.mdは短く、詳細は別ファイルへ — Microsoft Learnも500行以内を目安にしています。
1スキル1仕事 — 複数の workflow を抱えると発動判断が濁る。
具体的な実例を入れる — 抽象的なルール列挙より、入出力の例が効く。

デスク上のチェックリスト — Photo: Matthew Crisp / CC BY 2.0（Openverse経由）

descriptionの良し悪しを比べる

	例	問題/利点
悪い例	文書を処理するスキル	曖昧で、どの場面か判断できない
良い例	会議メモから議事録を作成する。ユーザーが「議事録」「meeting notes」に言及したときに使う。	何をするか＋いつ使うかが明確

最小構成のひな形

.claude/skills/meeting-minutes/
├── SKILL.md
└── template.md

--- SKILL.md ---
---
name: meeting-minutes
description: 会議メモから議事録を作成する。「議事録」「meeting notes」と言われたときに使う。
---
# 手順
1. メモから決定事項・TODO・担当者を抽出する
2. template.md の形式に整形する
3. 不明点は推測せず「要確認」と記載する

配置場所は .claude/skills/ が基本です。Claude Codeのスキル関連ドキュメントでは、旧カスタムスラッシュコマンド(.claude/commands/)もスキルに統合されつつあると説明されています。