Claude Code Skillsの使い方と自作方法を解説

この記事の結論
・Claude Code Skillsは`SKILL.md`を置くだけでClaudeに手順・知識を追加できる仕組み。`/スキル名`で呼び出すか、会話に合わせてClaudeが自動で読み込む。

・保存場所は個人用が`~/.claude/skills/`、プロジェクト共有用が`.claude/skills/`。バンドル済みスキルは2026年11月時点で20個。

・自作スキルはSKILL.mdのフロントマターにdescriptionを書くだけで使える。`!`コマンドで動的コンテキストも注入できる。

「毎回同じ手順をチャットに貼り付けるのが面倒」「CLAUDE.mdが長くなりすぎて管理しにくい」――Claude Codeを使い込んでいると、こういった課題が出てきます。そのような状況を解決するのがClaude Code Skillsです。

本記事では、Claude Code Skillsの基本的な仕組みから、バンドル済みスキル一覧・使い方・自作方法まで、公式ドキュメントをベースにわかりやすく解説します。Claude Codeを日常的に使っているエンジニアや開発者の方が、すぐに実践できる内容です。

Claude Code Skillsとは

Claude Code Skillsは、`SKILL.md`というファイルにClaudeへの指示を書いておくと、必要なときだけ自動で読み込まれる仕組みです。Anthropic公式ドキュメントでは「スキルはClaudeができることを拡張する」と説明されています。

通常のプロンプトと異なるのは、「呼ばれたときだけ本文が読み込まれる」点です。CLAUDE.mdに全手順を書き込むと常時コンテキストを消費しますが、Skillsはトークンを節約しながら、必要な場面にだけ詳細な指示を提供できます。

CLAUDE.mdやカスタムコマンドとの違い

Claude Codeには複数の設定ファイルがあります。それぞれの役割を整理します。

種類	役割	読み込みタイミング
CLAUDE.md	常時参照するプロジェクトの基本情報・ルール	常時（コンテキストを常に消費）
Skills（SKILL.md）	特定の作業手順・チェックリスト・ベストプラクティス	呼ばれたときだけ（トークン節約）
カスタムコマンド（.claude/commands/）	Skillsにマージ済み。同じ動作をする（後方互換あり）	呼ばれたときだけ

公式ドキュメントによれば、2026年時点でカスタムコマンドはSkillsにマージされており、`.claude/commands/deploy.md`と`.claude/skills/deploy/SKILL.md`はどちらも`/deploy`として同じように動作します。既存の`.claude/commands/`ファイルはそのまま使い続けられます。

Skillsが向いているシチュエーション

Anthropicは次のようなケースでSkillsの作成を推奨しています。

• 同じ指示・チェックリスト・複数ステップの手順をチャットに何度も貼り付けている
• CLAUDE.mdのセクションが「事実」ではなく「手順」に成長してきた
• チームで共通の作業手順を共有・標準化したい
• ライブdiffや実行結果など、動的な情報をコンテキストに含めたい

Claude Code自体の基本的な使い方はClaude Codeの日本語設定と基本操作ガイドで解説しています。

バンドル済みスキル一覧（2026年11月版）

Claude Codeにはインストール不要で使えるバンドル済みスキルが標準搭載されています。公式ドキュメントの2026年11月5日時点の情報によれば、バンドル済みスキルは20個です。

標準搭載の主要スキル一覧

スキル名	内容	自動呼び出し
/code-review	コミット前の差分にあるバグ・品質問題を確認する	あり
/doctor	Claude Codeの設定・拡張・認証状態を診断する	なし
/debug	エラーの原因を体系的に調査・修正する	あり
/batch	複数のサブエージェントで大規模タスクを並列処理する	なし
/loop	指定したプロンプト・スラッシュコマンドを繰り返し実行する	なし
/claude-api	Claude APIやAnthropicのSDKを使ったアプリ開発を支援する	あり
/simplify	変更したコードの品質・再利用性・効率を確認し修正する	あり
/verify	変更内容の正確性・安全性・完成度を最終確認する	なし
/run	プロジェクトのアプリを起動して動作を確認する	あり
/workflow-authoring	動的ワークフローを設計・記述する（動的ワークフロー有効時のみ）	なし

`/verify`・`/batch`・`/loop`などは呼び出した場合にのみ実行されます。自動呼び出しで常時動くわけではないため、時間とトークンを使うタイミングを自分でコントロールできます。

条件付きで利用できるスキル

一部のスキルは特定の機能が有効な場合にのみ使用できます。`/workflow-authoring`は動的ワークフロー機能が有効な環境でのみ利用可能です。また、`/run`は実行環境に依存するため、プロジェクトの起動設定（run-skill-generatorで自動生成可）が必要な場合があります。

Claude Code Skillsの使い方

Skillsの使い方は大きく2通りあります。直接呼び出す方法と、Claudeが自動で読み込む方法です。

スキルの呼び出し方

スキルを使うには`/`の後にスキル名を入力します。

直接呼び出し（コマンド形式）：

/code-review
/doctor
/my-custom-skill

自動呼び出し：
Claudeは会話の内容とSKILL.mdのdescriptionフィールドを照合し、関連するスキルを自動で読み込みます。たとえば「今の変更点を確認して」と入力すると、descriptionに「コミット前の差分確認」と書かれた/code-reviewスキルが自動で呼ばれることがあります。

スキルの一覧確認・トークン確認方法

Claude Code内でスキルの一覧を確認するには`/skills`コマンドを使います。現在読み込まれているスキルの名前とトークン消費量が表示されます。トークン量が大きいスキルが自動で読み込まれないように制御したい場合は、SKILLごとにdescriptionの内容を絞り込んで自動呼び出しの条件を明確にするのが効果的です。

Claude Codeの複数エージェントを使ったタスク分割についてはClaude Codeサブエージェント完全ガイドで詳しく解説しています。

自作スキルの作り方（SKILL.mdの書き方）

独自のワークフローや繰り返し行う手順をSkillとして登録すると、毎回指示を書かずに再利用できます。作成は難しくなく、SKILL.mdファイルを1つ作るだけです。

保存場所とディレクトリ構造

スキルの保存場所によって、どのセッションで使えるかが決まります。

保存場所	有効範囲	用途
`~/.claude/skills/スキル名/SKILL.md`	自分のすべてのプロジェクト	個人専用のルーティン
`.claude/skills/スキル名/SKILL.md`（リポジトリ内）	そのリポジトリで作業する全員	チーム共通の手順共有

ディレクトリ構造の例（個人用のコミットサマリースキルを作成する場合）：

~/.claude/skills/
└── summarize-changes/
    └── SKILL.md

SKILL.mdの書き方（フロントマターと本文）

SKILL.mdは「フロントマター（YAML形式の設定部分）」と「本文（実行指示のMarkdown）」の2部構成です。

---
description: コミット前の変更を要約し、リスクにフラグを立てる。ユーザーが「何を変えたか」「コミットメッセージを書いて」「差分を確認して」と聞いたときに使う。
---

## 現在の変更内容

!`git diff HEAD`

## 指示

上記の差分を2〜3の箇条書きで要約し、エラー処理の漏れ・ハードコードされた値・更新が必要なテストなど、気になるリスクを列挙してください。diffが空の場合は「未コミットの変更はありません」と返してください。

フロントマターで最低限必要なのは`description`だけです。descriptionの内容は「いつこのスキルを使うべきか」を具体的に書くと、自動呼び出しの精度が上がります。

フロントマターには`name`・`description`以外にも、呼び出し権限の制御（`invoke`フィールド）やサブエージェント実行の設定など高度なオプションがあります。詳細はAnthropic公式ドキュメントを参照してください。

動的コンテキスト注入（`!`コマンド）の活用

SKILL.md内で“ !`コマンド` “の形式を使うと、スキルが呼ばれた瞬間にコマンドを実行し、その出力をコンテキストとして注入できます。これを「動的コンテキスト注入」といいます。

たとえば`!`git diff HEAD“と書けば、スキル実行時点の最新diff（変更差分）がClaudeに渡されます。静的な手順だけでなく、実際の作業状態をリアルタイムで参照させることで、より精度の高い回答が得られます。

おすすめスキル7選

バンドル済みスキルと公式プラグインの中から、実務で特に使いやすいスキルを7つ紹介します。まず試してみるのに適したものを選びました。

開発効率化・品質向上系（バンドル済み）

• /code-review：コミット前に差分のバグ・品質問題をチェック。プルリクエスト前の最後の確認に最適。自動呼び出しにも対応するため、変更後の確認依頼で自然に動く
• /simplify：変更したコードを整理・改善。リファクタリング時に効果的。重複コードの検出・関数の分割提案まで行う
• /verify：変更の正確性・安全性・完成度を最終確認する。重要なコミット前の「最後の砦」として活用できる
• /debug：エラーの原因を体系的に調査。スタックトレースや動作ログをコンテキストとして渡すと精度が上がる

環境セットアップ・診断系（バンドル済み）

• /doctor：Claude Codeの設定・拡張・認証を一括診断。「動かない」「エラーが出る」ときの最初の確認として使う
• /run：アプリを起動して動作確認。run-skill-generatorで起動手順を自動検出してプロジェクトに保存できる

プラグインで追加できる公式スキル

• skill-creator（公式プラグイン）：スキルを作るためのスキル。対話形式でワークフローを聞き取り、SKILL.mdのフォルダ構成・フロントマター・本文を自動生成する。最初の自作スキルを作るときに特に便利

Claude CodeをVSCodeと組み合わせた開発環境の構築はClaude Code VSCode拡張機能の使い方・設定で解説しています。また、CodexとClaude Codeのどちらを使うか迷っている場合はClaude CodeとCodexの比較記事が参考になります。

まとめ

Claude Code Skillsについて、基本的な仕組みから使い方・自作方法まで解説しました。要点を整理します。

• Skillsとは：SKILL.mdに手順を書いておくと、必要なときだけClaudeが読み込む仕組み。CLAUDE.mdとの使い分けはトークン効率で判断する
• バンドル済みスキル：/code-review・/debug・/simplify・/doctorなど20個が標準搭載。まずこれを使い込むのが最初の一歩
• 自作スキル：SKILL.mdにdescription（いつ使うか）と手順を書いてスキル名のフォルダに置くだけ。!`コマンド`で動的情報をコンテキストに注入できる
• 保存場所：個人用は`~/.claude/skills/`、チーム共有はリポジトリの`.claude/skills/`

まず試すなら、`/code-review`と`/doctor`をコミット前・環境確認の習慣として使い始めるのがおすすめです。慣れてきたらskill-creatorを使って自分のワークフローに特化したスキルを作ってみてください。