Claude Codeに同じ種類の作業を頼むたびに、「まず資料を読んで、こういう観点でまとめて、最後にこの形式で出力して」と、同じ説明を何度も入力していませんか。
こうした「繰り返し使う手順」を、一度書いておけば使い回せるようにするのが「スキル」というしくみです。この記事では、公式ドキュメントの内容にもとづいて、スキルとは何か、CLAUDE.mdとどう違うのか、どう作って呼び出すのかを整理します。結論を先に言うと、スキルは「必要なときだけ読み込まれる手順書」です。
スキルとは?
公式ドキュメントによると、スキルは `SKILL.md` というファイルに指示を書いておくと、それがClaudeの「道具箱」に加わるしくみです。Claudeは関連があると判断したときにスキルを使います。自分で「/スキル名」と入力して直接呼び出すこともできます。
公式ドキュメントは、次のような場面でスキルを作るとよいとしています。
- 同じ指示、チェックリスト、複数ステップの手順を、何度もチャットに貼り付けている
- CLAUDE.mdの一部が、「事実」ではなく「手順」になってきた
また、Claude Codeには、最初から使えるスキル(同梱スキル)もあります。たとえば `/code-review` や `/loop` などです。
CLAUDE.mdとの違い
ここが一番の違いです。公式ドキュメントでは、CLAUDE.mdの内容と違い、スキルの本文は「使われるときだけ」読み込まれると説明されています。長い参考資料を入れておいても、必要になるまではほとんど負担にならない、という考え方です。
| CLAUDE.md | スキル | |
|---|---|---|
| 向いている内容 | 事実・常に守ってほしいルール | 繰り返し使う手順 |
| 読み込まれるタイミング | 会話の最初から | 呼び出されたとき(普段は説明文だけが手元にある) |
| 例 | 「文章は丁寧語で書く」「このフォルダの役割」 | 「請求書の下書きを作る手順」「月次報告のまとめ方」 |
※例は、違いを分かりやすくするための一例です(公式ドキュメントの記載ではありません)。
CLAUDE.mdの詳しい内容は、Claude Codeの「CLAUDE.md」とは?で整理しています。
スキルが使われるまでの流れ
公式ドキュメントによると、通常の会話では、各スキルの「説明文(description)」だけがあらかじめ手元に入っていて、本文は呼び出されたときに読み込まれます。

呼び出し方は2通りです。
- 自動:Claudeが、頼まれた内容とスキルの説明文を照らし合わせて、合うと判断したときに使う
- 手動:メッセージの先頭に「/スキル名」と入力して、自分で呼び出す(例:`/deploy staging` のように、スキル名のあとに追加の指示も書けます)
そのため、説明文に「どんなときに使うスキルか」が伝わる言葉を入れておくことが大切です。反応しないときは、説明文に、利用者が実際に言いそうな言葉を入れると改善することがある、と公式ドキュメントにも書かれています。
スキルの作り方
基本は、フォルダを作り、その中に `SKILL.md` を置くだけです。ファイルの上のほうに設定(YAML形式の「frontmatter」)を書き、その下に指示文を書きます。公式ドキュメントにある、いちばん簡単な例は次の形です。
“` — name: api-conventions description: API design patterns for this codebase — When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation
“`
設定の項目はすべて任意で、公式ドキュメントでは `description` だけが推奨とされています。`name` を省略すると、フォルダ名がそのままスキル名になります。
保存場所は、使う範囲によって分かれます。
| 場所 | 使える範囲 |
|---|---|
| `~/.claude/skills/<スキル名>/SKILL.md` | 自分のすべてのプロジェクト |
| `.claude/skills/<スキル名>/SKILL.md` | そのプロジェクトだけ(共有したい場合はプロジェクトに含める) |
| プラグインの中の `skills/` | プラグインを入れた人 |
このほか、組織全体で配る置き場所もあります。
フォルダには、`SKILL.md` のほかに参考資料(`reference.md` など)やスクリプトも置けます。`SKILL.md` から参照しておくと、必要なときに読み込まれます。
呼び出しの設定を変える
よく使う設定を2つ挙げます。
| 設定 | 意味 |
|---|---|
| `disable-model-invocation: true` | Claudeが勝手に使わない。自分が「/スキル名」と入力したときだけ動く |
| `user-invocable: false` | 「/」のメニューには出さない。背景知識としてClaudeだけが使う |
公式ドキュメントは、デプロイやメッセージ送信のように「実行すると外に影響が出る作業」のスキルには、`disable-model-invocation: true` を付けるよう案内しています。
知っておきたい注意点
本文は簡潔に
公式ドキュメントでは、`SKILL.md` は500行以内を目安にし、詳しい資料は別ファイルに分けることが勧められています。呼び出された本文は会話の中に残るため、長いほど毎回の負担が増えるためです。
「確認なしで使えるツール」の設定は、そのときだけ
`allowed-tools` という設定で、そのスキルを実行している間は確認なしで使えるツールを指定できます。ただし、これはそのスキルを呼んだ間だけの許可で、ほかのツールを使えなくするものではありません。権限全体の考え方は、Claude Codeの「権限」とは?で整理しています。
作った直後は読み込み直しが必要なことがある
既存のスキルフォルダの編集は、再起動しなくても反映されます。一方、新しく「スキルを入れる最上位のフォルダ」を作った場合は、`/reload-skills` が必要になることがあると公式ドキュメントに書かれています。
以前の「カスタムコマンド」はスキルに統合された
以前から使われていた `.claude/commands/` のファイルは、引き続き動きます。ただし、新しく作る場合はスキルが推奨されています。補助ファイルを置けるためです。
よくある疑問
スキルを使わないと、Claude Codeは使えませんか?
いいえ。基本的な使い方にスキルは必須ではありません。同じ説明を何度も繰り返していると感じたときに、あとから取り入れる機能です。
自分でSKILL.mdを書くのが不安です。
最初から書かなくても大丈夫です。公式ドキュメントには、スキルの作成や改善を手助けする仕組みも紹介されています(詳しい手順は、本記事では取り上げていません)。
どの作業をスキルにすればいいのか分かりません。
当社では、Claude Codeの説明から導入までをサポートしています。やりたいことを伝えていただければ、設定は当社で行います。見積りはヒアリングのうえ、個別に対応します。何を任せるかの考え方は、AIエージェントに任せやすい仕事、任せにくい仕事の見分け方でも整理しています。
まとめ
スキルは、`SKILL.md` に書いた手順を、必要なときだけ読み込んで使うしくみです。「毎回同じ説明をしている」と感じる作業を、使い回せる手順書にできます。
CLAUDE.mdには「常に守ってほしいルール」、スキルには「繰り返し使う手順」と使い分けるのが基本です。最初は説明文だけを書いた簡単なスキルを1つ作り、「/スキル名」で呼び出してみるところから始めるのが無理のない進め方です。



