Claude Codeのスキルとサブエージェントの違い（CLAUDE.mdとの使い分け）

3つは「いつ読まれるか」で分かれている

まず全体像です。3つとも、やっていることは「文章を書いたファイルを決まった場所に置く」だけで、プログラムは書きません。違うのは読み込まれるタイミングです。

CLAUDE.mdは、起動するたびに毎回読まれます。だから「常に守ってほしいこと」を書きます。スキルは、関係のある作業を頼んだときだけ読まれます。だから「特定の作業の手順」を書きます。サブエージェントは、読まれるのではなく、別の会話が立ち上がってそこで働きます。だから「まるごと任せたい仕事」を渡します。

この違いは、単なる置き場所の違いではありません。**一度に扱える会話の量には上限がある**ので、何を毎回読ませるかは、そのまま使える余力に効いてきます。全部CLAUDE.mdに書けばいい、とはならないのはこのためです。

CLAUDE.md ── 毎回読まれる「前提」

作業フォルダに置いておくと、起動のたびに自動で読み込まれるファイルです。ここに書くのは、どの作業にも共通してほしいことに限ります。

向いているのは、守ってほしい形式（日付の書き方、ファイル名の付け方）、使ってほしい言い回し、触ってはいけないファイル、といった前提です。「うちの会社では請求書はこの形式」を毎回説明しているなら、それはCLAUDE.mdに書くべき内容です。

逆に、特定の作業でしか使わない手順を書くと逆効果になります。毎回読まれるので、関係ない場面でも指示が効いてしまい、かえって出力がぶれます。最初から完璧に書こうとせず、**実際に使っていて「今の指示は毎回言っているな」と気づいたものを1行ずつ足していく**のが続けやすい方法です。使ってもいない決まりごとを大量に書くのがいちばん失敗します。

スキル ── 必要なときだけ読まれる「手順書」

決まった場所にフォルダを作り、その中に手順を書いたファイルを置くと、関係する作業を頼んだときだけ読み込まれます。毎回は読まれないので、いくつ作っても普段の会話を圧迫しません。

向いているのは、月に何度も繰り返す作業です。経費の集計、週報の作成、議事録の整形など、手順が決まっているものを書いておけば、以降は「週報を作って」の一言で毎回同じ品質で動きます。プロンプトを探して貼り付ける手間そのものが無くなります。

プロンプトとの使い分けは単純です。一度きりならプロンプト、繰り返すならスキル。迷ったら、その作業を3か月以内にまたやるかどうかで決めてください。下に挙げたスキルはそのままコピーして使えるので、まず1つ動かしてみるのが早いです。

サブエージェント ── 別の会話に「任せる」

ここが他の2つと決定的に違います。サブエージェントは読み込まれるのではなく、**独立した会話が別に立ち上がって、そこで作業し、結果だけを返してきます。**

何が嬉しいかというと、途中経過がこちらの会話に残らないことです。たとえば「フォルダの中の200ファイルを全部見て、条件に合うものを探す」という作業を普通に頼むと、200ファイルぶんのやりとりが会話を埋めてしまい、その後の作業で最初の指示を忘れられる、という状態になります。サブエージェントに任せれば、返ってくるのは結論だけです。

もう1つは役割を固定できることです。「この観点でだけ確認する」という専門の担当を作っておくと、毎回その観点で見てくれます。使える道具を絞ることもできるので、調べるだけでファイルは書き換えない、といった任せ方も可能です。

向いていないのは、短い作業や、途中を見ながら進めたい作業です。別の会話に渡すぶん手間が増えるので、すぐ終わることを任せると遅くなります。

どれを作るかの決め方

迷ったときは、次の順で自問すると決まります。

**「どの作業でも守ってほしいことか」** ── はい、ならCLAUDE.md。日付の形式やファイルの扱いなど、常に効いてほしいものです。

**「特定の作業の手順で、また繰り返すか」** ── はい、ならスキル。月次の集計や定例の書類が典型です。

**「途中経過が長くなる、または役割を固定したいか」** ── はい、ならサブエージェント。大量の調査や、決まった観点での確認です。

どれにも当てはまらないなら、その場でプロンプトを渡せば十分です。**仕組みを作ること自体が目的にならないよう気をつけてください。** 一度しかやらない作業のためにスキルを書くのは、単に遠回りです。

スキルの作り方と、そのまま使える実物

手順は単純で、決まった場所にフォルダを作り、手順を書いたファイルを1つ置くだけです。書く内容は3つで、何をするスキルなのかの説明、いつ使うのか、そして実際の手順です。

コツは、説明の部分を具体的に書くことです。ここを見て「今の依頼に関係あるか」が判断されるので、曖昧だと呼び出されません。「議事録を整形する。会議の文字起こしを渡されたときに使う」のように、対象と場面をはっきり書きます。

手順は、自分が人に頼むときの説明をそのまま文章にすれば十分です。箇条書きで構いません。うまく動かないときは、手順を細かくするより、**判断に迷いそうな箇所に「こういう場合はこうする」を足す**ほうが効きます。

このサイトには、そのままコピーして使えるスキルを用意してあります。ゼロから書くより、近いものを1つ動かして中身を見るほうが早いです。

サブエージェントの作り方

こちらも、決まった場所にファイルを1つ置くだけです。書く内容は、どういう役割なのか、いつ呼ぶのか、そして守ってほしい進め方です。スキルとの違いは、**そのエージェントが持つ前提を全部書く必要がある**ことです。

理由は、別の会話として立ち上がるからです。こちらの会話で説明したことは伝わりません。「何を渡されて、何を返せばよいか」を、その文章だけで分かるように書く必要があります。ここを省くと、期待と違う結果が返ってきます。

使える道具を絞れる点も活かしてください。調査だけを任せるなら、ファイルを書き換える権限は渡さないほうが安全です。任せる範囲が狭いほど、返ってくる結果も安定します。

よくある失敗

いちばん多いのは、**CLAUDE.mdに何でも書いてしまう**ことです。毎回読まれるので、量が増えるほど普段の余力を圧迫し、しかも関係ない場面で指示が効いて出力がぶれます。特定の作業の手順はスキルに移してください。

次に多いのが、**まだ繰り返していない作業をスキルにする**ことです。実際にやってみると手順が変わるので、作ったスキルがすぐ合わなくなります。2回か3回は手でやってから、固まったところを書き出すほうが結果的に早いです。

もう1つ、**サブエージェントを短い作業に使う**のも遠回りです。別の会話を立てるぶん手間がかかるので、すぐ終わることは普通に頼んだほうが速く終わります。

最後に、作ったものが期待どおり動くかは必ず一度確認してください。3つとも「書いたつもりが読まれていない」ことがあり、その場合は静かに無視されるだけで、エラーは出ません。

よくある質問

スキルとサブエージェントはどちらを使えばいいですか？

手順が決まっていて繰り返す作業ならスキル、途中経過が長くなる作業や役割を固定したい作業ならサブエージェントです。決定的な違いは、スキルが同じ会話の中で手順を読み込むのに対し、サブエージェントは別の会話を立てて結果だけを返す点にあります。

CLAUDE.mdには何を書けばいいですか？

どの作業でも守ってほしい前提だけです。日付の書き方、ファイル名の付け方、触ってはいけないファイルなどが該当します。特定の作業の手順を書くと、関係ない場面でも効いてしまい出力がぶれるので、それはスキルに分けてください。

プログラミングの知識は必要ですか？

必要ありません。3つとも、文章を書いたファイルを決まった場所に置くだけです。難しいのは書き方ではなく、自分の業務の何を書くべきかを決めるところです。

作ったのに動きません。何を確認すればいいですか？

まず置き場所が正しいかを確認してください。3つとも、読み込まれていない場合はエラーが出ず静かに無視されます。次に、スキルの場合は説明文が曖昧でないかを見てください。ここを見て呼び出すかが判断されるので、対象と場面が具体的に書かれていないと反応しません。

スキルはいくつ作っても大丈夫ですか？

問題ありません。スキルは関係する作業のときだけ読み込まれるので、数が増えても普段の会話を圧迫しません。毎回読まれるCLAUDE.mdとはここが違います。

関連する解説ガイド

• Claude Codeでできること（非エンジニア向け）：コードを書かない人がClaude Codeで実際に片付けられる作業を、ファイル整理・データ処理・書類作成の順に具体例で紹介します。
• Claude CodeのMCP設定と、つながらないときの切り分け：MCPで外部サービスをつなぐときの設定の考え方と、認識されない・エラーになる場合の原因を切り分け順にまとめました。WindowsとMacで書き方が変わる箇所、鍵の扱い、社内ネットワークでの遮断まで扱います。
• Claude Codeがうまく動かないときに見る8箇所：インストールは終わったのに思った通りに動かない、という状態をほどくためのチェックリストです。作業フォルダ・権限・CLAUDE.md・スキル・MCPの順に、詰まりやすい箇所と直し方をまとめました。