Claude Code の Skills とは？作り方と使いどころ

「毎回同じ指示をClaude Codeに貼り付けている」——そう感じた瞬間が、Skills を使い始めるサインです。コーディング規約、デプロイ手順、レビューチェックリスト。チームで決めたはずのルールを、毎回プロンプトに書き直すのは非効率です。Claude Code の Skills は、その繰り返しをなくすための仕組みです。

この記事では、Claude Code の公式ドキュメント（スキルで Claude を拡張する）をベースに、Skills の概念・設定ファイルの書き方・MCP との違い・実際の使いどころを順に整理します。読み終えたあとには、自分のプロジェクトに合った Skills を作れるようになります。

この記事のポイント

Skills は SKILL.md ファイルに指示を書くだけで Claude の振る舞いをカスタマイズできる仕組み。コード不要
MCP が「外部ツールとの接続」なのに対し、Skills は「Claude Code の振る舞いのカスタマイズ」。役割が異なる
主な保存先はグローバル（全プロジェクト共通）とプロジェクト単位の2つ。プロジェクト単位はチーム共有にも使える

なぜ Skills が必要なのか——背景と基本概念
1. Skills が登場した背景と位置づけ
2. Bundled Skills（組み込みスキル）との違い
Claude Code Skills と MCP はどう違うのか？
1. MCP（Model Context Protocol）の役割
2. Skills が担う範囲と使い分けの考え方
Claude Code Skills の作り方：設定ファイルの書き方と手順
どんな場面で Claude Code Skills を使うべきか？
1. 繰り返しタスクの自動化に向いているケース
2. チーム開発での共有・標準化への活用
Claude Code Skills に関するよくある質問（FAQ）
まとめ
参考サイト

なぜ Skills が必要なのか——背景と基本概念

Skills は、Claude Code に「特定の仕事の進め方」を教えるための仕組みです。Claude Code 公式ドキュメント（日本語版）では、「SKILL.md ファイルに指示を記述すると、Claude はそれをツールキットに追加する」と説明されています。

Qiita の解説記事（2026年3月）では「ポータブルな専門知識のバンドル」と表現されており、イメージしやすい例えです。

Skills が登場した背景と位置づけ

Claude Code を使い始めると、同じ指示を何度も入力する場面が出てきます。「変数名は camelCase で」「エラーハンドリングはこのパターンで」「テストは Jest で書いて」——こうした指示を毎回入力する手間を省くために Skills は設計されました。

Anthropic は Agent Skills 機能を正式リリースし、公式ガイド『The Complete Guide to Building Skills for Claude』（全32ページ）を公開しています（Zenn の日本語解説記事より。リリース時期の詳細は公式ドキュメントでご確認ください）。

位置づけとしては、CLAUDE.md が「プロジェクト全体の方針・技術スタック・命名規則」を定義するのに対し、Skills は「個別タスクの手順・チェックリスト・繰り返し使うプロシージャ」を担います。CLAUDE.md の一部が手順書に膨らんできたら、それを Skills に切り出すタイミングです。

なお、Qiita の解説記事（2026年3月）によると、繰り返し発生する指示をスキルとして定義しておくことで、毎回の入力コストを大幅に削減できます。これは個人の作業効率だけでなく、チーム全体の品質安定にも寄与します。

Bundled Skills（組み込みスキル）との違い

Claude Code には、最初から使えるバンドルスキルが含まれています。公式ドキュメント（英語版）によると（2026年9月時点。最新のバンドルスキル一覧は公式ドキュメントを参照）、/doctor・/code-review・/batch・/debug・/loop・/claude-api などがバンドルスキルとして提供されています。

これらはプロンプトベースで動作し、インストール不要で即座に使えます。

一方、カスタム Skills はユーザー自身が SKILL.md を書いて作るものです。両者の関係は次の表で整理できます。

種類	作成者	呼び出し方	主な用途
バンドルスキル	Anthropic	`/debug` など	汎用的なコーディング支援
カスタムスキル	ユーザー / チーム	`/skill-name` または自動	プロジェクト固有の手順
カスタムコマンド（旧）	ユーザー	`/command-name`	Skills に統合済み（後方互換あり）

なお、公式ドキュメントによると、カスタムコマンド（.claude/commands/）と Skills（.claude/skills/）は統合されました。既存の .claude/commands/ ファイルはそのまま動作するため、移行は任意です。

Claude Code Skills と MCP はどう違うのか？

Claude Code を使い込んでいくと、「Skills と MCP（Model Context Protocol）はどう使い分ければいいのか」という疑問が出てきます。両者は目的が根本的に異なります。混同しやすいですが、役割を理解すれば使い分けは明確です。

MCP（Model Context Protocol）の役割

MCP は、Claude Code と外部ツール・サービスを接続するためのプロトコルです。データベース、API、ファイルシステム、Web サービスなど、Claude の外側にある情報源やツールを呼び出す「橋渡し役」を担います。

たとえば、GitHub の Issue を取得したり、社内の Slack チャンネルにメッセージを送ったり、PostgreSQL のクエリを実行したりする場合に MCP を使います。外部システムとのやり取りが発生するところに MCP がある、と覚えておくと整理しやすいでしょう。

Skills が担う範囲と使い分けの考え方

genai-ai.co.jp の解説記事（2026年8月）では、「MCP は外部ツールとの接続、Skills は Claude Code の振る舞いのカスタマイズ」と整理されています。Skills は外部との通信を必要とせず、SKILL.md に書いた指示を Claude が読み込んで実行するだけです。

使い分けの判断基準は次の通りです。

外部 API・DB・サービスを呼び出す → MCP
Claude の作業手順・チェックリストを定義する → Skills
両方が必要な複合タスク → MCP でデータを取得し、Skills で処理手順を定義する

また、Uravation の記事（2026年8月）によると、Skills は context:fork（コンテキストを分岐させてサブエージェントを独立実行する仕組み）によってサブエージェント上での分離実行にも対応しており、Agent と Skills を組み合わせた複雑なワークフローも構築できます。

Agent が「司令塔」として全体を制御し、Skills が「専門部隊」として個別タスクをこなす関係です。

Claude Code Skills の作り方：設定ファイルの書き方と手順

Skills の作成はコードを書く必要がありません。フォルダを作り、SKILL.md を置くだけです。公式ドキュメントと各種解説記事をもとに、具体的な手順を整理します。

SKILL.md ファイルの書き方

Skills の中心となるのは SKILL.md ファイルです。ファイルの先頭に YAML フロントマターでメタデータを定義し、その後に具体的な指示を記述します。

Qiita の解説記事（2026年3月）によると、フォルダ構成はシンプルです。

my-skill/
├── SKILL.md       # 必須: 指示とメタデータ
├── scripts/       # 任意: 自動化スクリプト
├── references/    # 任意: 参照資料
└── assets/        # 任意: その他のリソース

SKILL.md のフロントマターには、name・description などを YAML 形式で記述します（公式ドキュメントより）。以下は、コードレビュー用スキルの記述例です。

---
name: code-review
description: コードレビューを実行する。PRやコミットを受け取ったときに使用。
---
## やること
1. 命名規則の確認（camelCase / PascalCase など規約に沿っているか）
2. エラーハンドリングの有無（try-catch や戻り値の型チェック）
3. テストカバレッジの確認（Jest でのテストが存在するか）
4. 不要なコメント・デバッグログの除去
5. セキュリティ上の懸念事項（SQL インジェクション・XSS など）

本文（フロントマター以降）には、Claude に実行させたい手順・チェックリスト・判断基準を自然言語で書きます。description に「どんなときに使うか」を明示的に書くと、自動適用の精度が上がります。

なお、公式ドキュメントによれば、SKILL.md の本文は必要なときだけ読み込まれる仕組みのため、参照資料が長くなってもコンテキストウィンドウを圧迫しません。CLAUDE.md の一部が手順書に膨らんできたら Skills に切り出すことが推奨されています。

Skills のロード先を選ぶ（グローバル／プロジェクト単位）

保存先によって Skills の有効範囲が変わります。UnionAI ブログ（2026年6月）によると、よく使う保存先は次の2つです（公式ドキュメントでは、ほかに組織の管理設定・プラグイン・--add-dir で渡したフォルダなども挙げられています）。

種類	保存パス	有効範囲	向いているケース
グローバル（Personal）	`~/.claude/skills/スキル名/`	すべてのプロジェクト	個人の作業スタイル統一
プロジェクト単位	`.claude/skills/スキル名/`	配置したプロジェクトのみ	チーム共有・リポジトリ管理

チームで共通の Skills を使いたい場合は、プロジェクト単位の .claude/skills/ をリポジトリに含めて Git で管理するのが現実的です。新しいメンバーがリポジトリをクローンするだけで、同じ Skills が使えるようになります。

動作確認とデバッグの進め方

Skills の読み込みはファイルを置くだけで自動認識されます。公式ドキュメントによると、Claude Code はスキルのフォルダの変更を見張っていて、SKILL.md を追加・編集・削除すると、再起動しなくても同じセッションの中で反映されます。セッションの途中で新しく作ったスキルのフォルダは、/reload-skills で読み込みます。

動作確認は次の手順で進めます。

スラッシュコマンドで呼び出す：/skill-name を入力し、Skills が認識されているか確認する
関連タスクを依頼する：Skills の説明に合ったタスクを自然言語で依頼し、自動適用されるか確認する
SKILL.md を直してもう一度試す：期待通りに動かない場合は、指示の表現を具体的に書き直す（保存すればそのまま反映され、再起動は要りません）

よくある問題は「指示が曖昧すぎて Claude が Skills を使うべき場面を判断できない」ケースです。description に「どんなときに使うか」を明示的に書くと、自動適用の精度が上がります。

⚠️ セキュリティに関する注意

Claude Code 週次アップデートまとめ（2026年9月）によると、Skills のツール許可設定が管理ポリシーを迂回していた脆弱性が修正されました。セキュリティポリシーを運用している場合は、最新バージョンへの更新後に設定を再確認してください。

また、genai-ai.co.jp の解説記事（2026年8月）では、公開 Skills のセキュリティ問題についても触れられており、外部から取得した Skills を利用する際には内容を事前に確認することが推奨されています。

どんな場面で Claude Code Skills を使うべきか？

Skills が力を発揮するのは、「繰り返し発生するタスク」と「チーム全体で統一したい手順」の2つです。どちらも、毎回プロンプトを書き直す手間を省き、作業の質を安定させる効果があります。

繰り返しタスクの自動化に向いているケース

同じ手順を何度も実行するタスクは、Skills の典型的な使いどころです。UnionAI ブログでは、以下のような用途が紹介されています。

コード生成・補完：命名規則・エラーハンドリングパターン・テストフレームワークをスキルに定義し、毎回の指示を省略する
コードレビュー：チェックリストをスキルに書き、/code-review を呼び出すだけでレビューを実行する
ドキュメント生成：API ドキュメントや README のフォーマットをスキルに定義し、出力形式を統一する
デプロイ・リリース手順：デプロイ前の確認項目をスキルにまとめ、手順漏れを防ぐ

Zenn の解説記事では、繰り返し指示をスキルとして定義しておくことで、都度の入力コストをゼロに近づけられる事例が紹介されています（あくまで事例の紹介であり、効果は利用状況によって異なります）。

チーム開発での共有・標準化への活用

Skills の大きな利点のひとつが、チーム全体での共有です。プロジェクトの .claude/skills/ に Skills を置いてリポジトリに含めれば、チームメンバー全員が同じ Skills を使えます。

具体的な効果として、次のような場面が考えられます。

新メンバーがコーディング規約を覚える前でも、Skills があれば規約に沿ったコードを出力できる
レビュアーによって指摘内容がばらつく問題を、共通のレビュースキルで標準化できる
リリース手順の属人化を防ぎ、誰がデプロイしても同じ手順で実行できる

公式ドキュメントによると、Claude Code は Agent Skills オープンスタンダードに準拠しており、Claude Code 以外の複数の AI ツール間でも Skills が機能します。将来的にツールを乗り換えた場合でも、作成した Skills の資産を活かせる可能性があります。

Claude Code Skills に関するよくある質問（FAQ）

Skills を使い始める前後に出やすい疑問をまとめました。公式ドキュメントと各種解説記事をもとに回答します。

Q. Skills は SDK なしで使えるのか

A. 使えます。Skills の作成に必要なのは SKILL.md ファイルを書くことだけで、プログラミングも SDK のインストールも不要です。フォルダを作成し、SKILL.md を置くだけで Claude Code が自動認識します。スクリプトを使いたい場合は scripts/ フォルダに追加できますが、これは任意です。

テキストエディタだけで完結するのが Skills の大きな特徴です。

Q. 既存の Agent 設定と共存できるか

A. 共存できます。Agent と Skills は対立する概念ではなく、組み合わせて使うものです。Agent がタスク全体の分解・実行順序の判断を担い、Skills が個別タスクの実行を担います。既存の CLAUDE.md や Agent 設定はそのままで、Skills を追加するだけで機能します。

また、旧来の .claude/commands/ ファイルも引き続き動作するため（公式ドキュメントより）、既存の設定を壊す心配はありません。

Q. Skills を呼び出す方法は2種類あると聞いたが、どう使い分けるのか

A. 公式ドキュメントによると、スラッシュコマンド（/skill-name）による明示的な呼び出しと、Claude が関連性を判断して自動的に使用する2種類があります。デプロイや特定の手順のように「このタイミングで必ず使いたい」ケースはスラッシュコマンドが向いています。

コーディングスタイルのように「常に適用したい」ケースは、description に使用条件を明示しておくと自動適用されやすくなります。

Q. バンドルスキルを無効にすることはできるか

A. 設定で無効化できます。ただし、disableBundledSkills をオンにしても、/doctor コマンドはタイプ可能なまま残る場合があります。完全に非表示にするには DISABLE_DOCTOR_COMMAND 環境変数または skillOverrides で 'doctor':'off' を設定する必要があります。

なお、この仕様は今後変更される可能性があるため、最新情報は公式ドキュメントでご確認ください（Claude Code 週次アップデートまとめも参考になります）。

Q. Skills の仕様は今後も変わるのか

A. 変わる可能性があります。公式ドキュメントは頻繁に更新されており、Skills の仕様は現在も活発に改善が続いています。記事公開後も最新仕様は公式ドキュメント（日本語版）やAnthropic リリースノートで随時確認することをお勧めします。

まとめ

ここまで読んで、Skills の全体像は掴めたはずです。あとは実際に1つ作るだけです。まず自分が毎回 Claude Code に貼り付けている指示を1つ選んで SKILL.md に書き起こすところから始めてみてください。その1ファイルが、日々の開発フローを少しずつ変えていきます。

この記事で整理した内容を振り返ります。

Skills は SKILL.md ファイルに指示を書くだけで作れる。コード不要（公式ドキュメントより）
MCP が「外部ツールとの接続」なのに対し、Skills は「Claude の振る舞いのカスタマイズ」
主な保存先はグローバル（個人用）とプロジェクト単位（チーム共有）の2つ
バンドルスキル（/debug・/code-review など）はすぐ使える。カスタムスキルは自分で定義する
Agent Skills オープンスタンダードに準拠しており、複数ツール間での互換性がある

※本記事の情報は2026年9月時点のものです。最新情報は各公式サイトでご確認ください。
最終更新: 2026年9月27日