Claude Code Skills とは・使い方・作り方|SKILL.md で専門手順を覚えさせる【2026年版】
この記事でわかること
- Skills とは:必要なときだけ読み込まれる「専門手順書」。本体の知識を文脈に応じて拡張する
- プログレッシブディスクロージャ:普段は description だけ、関連タスクで初めて本文が読まれる仕組み
- 作り方:.claude/skills/<名前>/SKILL.md に frontmatter(name/description)+ 手順を書く
- サブエージェント・スラッシュコマンドとの違いと使い分け
- スクリプトや参照ファイルを同梱して再利用性を上げる方法
結論:Skills は「必要なときだけ読まれる専門手順書」
Claude Code の Skills は、特定タスクのやり方をまとめた手順書を、関連する作業のときだけ Claude に読み込ませる仕組みです。フォルダに SKILL.md を置いておくと、そのスキルが関係するタスクが来たとき Claude が自動で手順を読み込んで従います。
毎回同じ指示を貼り付ける必要がなくなり、チームで作業手順を標準化できます。「議事録のフォーマット規約」「リリース手順」「特定ライブラリの使い方」などを一度スキルにすれば、誰の Claude Code でも同じやり方で作業できます。
この記事では Skills の仕組み・作り方・サブエージェントやコマンドとの違い・運用のコツを、実例つきで解説します。
仕組み:プログレッシブディスクロージャ
Skills の核心は 「段階的な読み込み(progressive disclosure)」 です。
- 常時:各スキルの
description(短い説明)だけがコンテキストに乗っている - タスクが関連したとき:その SKILL.md 本文が読み込まれる
- さらに必要なとき:SKILL.md から参照された同梱ファイル(スクリプト・資料)が読まれる
この設計のおかげで、スキルを何十個用意してもコンテキストを圧迫しません。普段は短い説明だけが見えていて、関連するものだけが展開されるからです。だから description が「いつ発火するか」を決める最重要要素になります。
Skills・サブエージェント・スラッシュコマンドの違い
似た拡張機能が3つあるので整理します。
| Skills | サブエージェント | スラッシュコマンド | |
|---|---|---|---|
| 実体 | 必要時に読む手順書 | 別コンテキストのAI | 定型プロンプト |
| コンテキスト | 本体に段階的に読み込む | 本体と分離 | 本体に展開 |
| 同梱 | スクリプト・資料も可 | システムプロンプト | プロンプトのみ |
| 向く用途 | 専門手順を本体に教える | 重い作業を委譲・並列 | よく使う指示の短縮 |
| 置き場所 | .claude/skills/ | .claude/agents/ | .claude/commands/ |
手順や規約を本体に教えたいだけなら Skills、本体を汚さず重い作業を丸ごと任せたいならサブエージェント(詳説)、よく使う一言指示を短縮したいだけならコマンド、という使い分けです。
作り方:最小スキル
.claude/skills/meeting-notes/SKILL.md を作ります。
---
name: meeting-notes
description: 会議の文字起こしや箇条書きメモから、社内標準フォーマットの議事録を作成する。「議事録を作って」「この打ち合わせをまとめて」などで使う。
---
# 議事録作成スキル
入力(文字起こし・メモ)から、次の構成で議事録を作成してください。
## 出力フォーマット
1. **日時 / 参加者**
2. **決定事項**(誰が・何を・いつまでに、を明記)
3. **議論の要点**(論点ごとに3行以内)
4. **ToDo**(担当者と期限つきの箇条書き)
5. **次回予定**
## ルール
- 推測で参加者名や数値を補わない。不明は「(不明)」と書く
- 決定事項とToDoは必ず担当者を明記する
- 雑談・脱線は省く
これだけで meeting-notes スキルが使えます。「この打ち合わせメモを議事録にして」と頼むと、Claude がこの手順を読み込んで標準フォーマットで出力します。
要素:
name:スキルの識別子。description(最重要):何をする/いつ使うを具体的に。これだけが常時コンテキストに乗り、発火判断に使われます。- 本文:Claude が従う手順・規約・出力形式・禁止事項を Markdown で。
補助ファイルを同梱して再利用性を上げる
Skills の強みはフォルダ単位であること。SKILL.md 本文を短く保ちつつ、長い資料やスクリプトを別ファイルにして参照させられます。
.claude/skills/release/
├── SKILL.md # 手順の本体(短く保つ)
├── checklist.md # 詳細チェックリスト(必要時に読む)
└── bump_version.py # バージョン更新スクリプト
SKILL.md から「詳細は checklist.md を参照」「bump_version.py を実行」と書いておけば、Claude は必要になったときだけそれらを読みます。本文を肥大化させずに、深い手順やツールを持たせられます。
配置場所とチーム共有
| 置き場所 | スコープ | 用途 |
|---|---|---|
.claude/skills/<名前>/(リポジトリ) | プロジェクト専用 | チーム共通の規約・手順(Git共有) |
~/.claude/skills/<名前>/(ホーム) | 自分の全プロジェクト | 個人の汎用スキル |
チームで作業手順を標準化したいものはプロジェクト側に置いてコミットします。これで全員の Claude Code が同じやり方で作業し、属人化を防げます。プラグイン/マーケットプレイス経由で配布されるスキルもあります。
呼び出され方
- 自動発火:タスクが
descriptionに合致すると Claude が自動でスキルを読み込みます。 - 明示実行:ユーザー起動可能なスキルは
/<スキル名>で直接呼べます。
自動発火を効かせる鍵は、やはり description の具体性です。対象(何を扱うか)と用途(いつ使うか)を両方書きます。
ベストプラクティス
- 1スキル=1目的:巨大な万能スキルは発火精度が落ちる。目的ごとに分ける。
- description に対象と発火条件を明記:常時コンテキストに乗る唯一の部分。ここが曖昧だと使われない。
- 本文は短く、詳細は別ファイルへ:長い資料・スクリプトは同梱して参照。SKILL.md はインデックス的に保つ。
- チーム共通手順をスキル化:レビュー規約・リリース手順・命名規則などを標準化し、属人化を防ぐ。
よくある誤解
- 「Skills は本体とは別のAI」→ 違います。本体のコンテキストに読み込まれる手順書です。別AIはサブエージェント。
- 「全部 SKILL.md 本文に書くべき」→ 違います。長い資料は別ファイルに分け、プログレッシブディスクロージャを活かします。
- 「description は短ければ短いほどよい」→ 違います。発火判断に使われるので、対象と用途を具体的に。
まとめ
- Skills=必要なときだけ読まれる専門手順書。
.claude/skills/<名前>/SKILL.mdで作る - プログレッシブディスクロージャ:普段は description だけ、関連タスクで本文、必要なら同梱ファイル
- frontmatter は
name/description(発火判断の最重要項目)、本文が手順 - スクリプト・資料を同梱して再利用性を上げ、SKILL.md 本体は短く保つ
- サブエージェント(別AI)・コマンド(定型指示)と使い分け、チーム共通手順を標準化
手を動かして定着させる:自分の繰り返し作業を1つスキルにすると効果がすぐ分かります。当サイトの「バイブコーディング実践編」では Claude Code を業務に組み込む際の規約づくり・安全設定を、提出物テンプレ + 採点ルーブリック付きの演習で扱います。4週間限定で無料公開中。
関連ガイド:
- Claude Code サブエージェントの作り方・使い方 — 別コンテキストに作業を委譲する拡張機能
- Claude Code 入門 — CLI の環境構築と基本
- Claude Code チュートリアル — 実例タスクで使い方を学ぶ
- MCPサーバーの作り方 — 外部ツール連携のもう一つの軸
関連する AI 研修コース・事例
このガイドで解説した内容を、提出物・採点ルーブリック付きの実装演習で 実務レベルまで定着させるためのコースと、国内外の AI 活用事例を見るための入口です。
- バイブコーディング実践編 (vibe_practice)Claude Code を業務コードに使うときの安全設定・許可コマンド・ ログ管理を、提出物付き 40 レッスンで体系化。4 週間限定で無料公開中。
- AIエージェント活用実践編 (agent_practice)Claude Agent SDK と MCP で AI を働かせる実装演習。 Claude Code に慣れた次のステップ。
- サイバーセキュリティ基礎 (cybersec_basic)AI を業務に取り入れる際の社内ガードレール・情報統制と一緒に学ぶ 実務者向けセキュリティ 40 レッスン。
- AI 活用事例集KDDI・SAP・freee・メルカリ等、国内外の企業 AI 導入実例を業種別に確認。
- AI研修 コース一覧概論レーン (経営者向け) + 実践レーン (エンジニア向け) の全 6 コースを一覧。