Claude CodeのSkills、Subagents、MCP、Plugins：どれを選ぶべきか

Claude Codeには、同じコードレビューを行う方法が5つあります。スラッシュコマンド、skill、subagent、plugin、あるいはチャットでの単なるプロンプトです。どの方法が常に優れているということはありません。選択はタスク、トークン予算、自分以外に誰が使うかによって決まります。

このガイドは、1年前の自分に渡したかったものです。4つの質問からなるツリー、すぐに使える「タスク → レイヤー」マトリクス、そして私が一緒に仕事をするvibe coderたちがトークンを浪費する、よくある5つの間違いを紹介します。

サービスの使い方については、Ailootのドキュメントをご覧ください。

Skills、subagent、MCP、pluginとは一言でいうと何か？#

選ぶ前に、用語を整理しましょう。4つのレイヤーはどれも、Claudeが標準でできることを拡張するのが目的です。ただし、それぞれ性質が異なります。

Skillは、特定の方法論をいつ、どのように適用するかを記したSKILL.mdファイルを含むディレクトリです。Anthropicはskillを新入社員向けの手順書にたとえています。毎日すべての手順を逐一指示するのではなく、手順を渡すのです。

Subagentは、メインの会話から起動される、独自のコンテキストを持った別のClaudeセッションです。重要な特徴は、隔離されていることです。subagentは30個のファイルを読み、要約を作成して、それだけをメインチャットに返せます。メインの会話のコンテキストはすっきり保たれます。

MCP（Model Context Protocol）は、Claudeを外部システムにつなぐためのAnthropic発のオープン標準です。2025年11月13日のブログ記事で、Anthropicはその違いを非常に明快に説明しました。

Pluginは、skill、subagent、hook、コマンドをまとめてマーケットプレイスで配布する、誰かが用意したセットです。/plugin installを使って1行でインストールすると、すべてを一度に利用できます。skillが自分の手順なら、pluginは別の会社から購入した手順です。

要するに、skillsはレシピ、subagentsは専門性を持つ同僚、MCPはClaudeがサービスやデータにアクセスするための外部ツールを提供します。トークンコストは異なります。skillは起動時に読み込まれるため最も安価ですが、MCPは接続した各サーバーがコンテキストウィンドウの領域を常に使うため、かなり高くつきます。

CLAUDE.mdを1つ使えばよいのに、なぜ4つのレイヤーが必要なのか？#

紹介したプロジェクトでは、CLAUDE.mdは大きなルールの地図です。何をどこに置くか、どう公開するか、どんな取り決めがあるかを記しています。このファイルがなければ、Claudeは新しいセッションを始めるたびにゼロから取り組むことになります。

しかし、CLAUDE.mdには限界があります。機能しなくなる3つの状況を説明します。

状況1：ルールがときどきしか機能しない。 CLAUDE.mdに「git pushの前に必ずnpm run buildを実行する」と書いてあります。Claudeはセッションの開始時に読み、うなずき、25回メッセージをやり取りした後にコードを書き始めて、忘れてしまいます。私はすでに3回、ビルドをせずにpushしてしまい、本番環境で失敗しました。正しく設定してテストしたフックは、決定的なビルド検査で対象操作を拒否できます。ただしイベントとツール経路が範囲を決め、別ターミナルやアプリからの全pushを自動では覆いません。意図的に失敗するビルドで、実際の経路が止まるか確認します。

状況2：15段階のプロセスを繰り返す。 ここで紹介する例では、すべてのガイドが14の段階を通ります。調査 → 構成 → MDX → 7つの並列QAチェック → 本番公開 → IndexNowです。毎回「ステージ1、次に2、次に3を実行して」とプロンプトを書くと、始める前にトークンを浪費してしまいます。そのため、このワークフロー全体をbuild-masterskaya-guide skillにまとめ、「プロジェクト用の新しいガイドを作ろう」というフレーズで起動できるようにしています。これは34 KBの指示セットです。

状況3：タスクがコンテキストを食い尽くす。 公開済みのガイドの情報が最新か確認するには、Claudeは30 KBのライブ配信文字起こし、各5 KBの振り返り20件を読み、現在のサイトと比較する必要があります。これをメインチャットで行うと、レビューの終わりにはコンテキストに不要なトークンが200Kもたまります。subagentなら同じ作業をしても、メインの会話には300語の要約だけを返して終了できます。

状況4：チームに自分と同じテンプレートを使ってほしい。 フロントエンド設計用の既製ルール、Coolify経由で公開するhook、Playwrightチェック用のMCP。これがpluginです。自分の環境をまとめてマーケットプレイスで公開し、同僚が1行でインストールできるようにします。

CLAUDE.mdは「ここではどう進めるか」という基本を担います。その上にある4つのレイヤーは、CLAUDE.mdでは物理的に対応できないこと、つまりトリガーによる反復、コンテキストの隔離、外部へのアクセス、共有を担います。

CLAUDE.mdではなくskillが必要なのはどんなときか？#

skillが必要かどうかの判断は簡単です。メモから同じ長いプロンプトをチャットにコピーしている自分に気づいたら、3回目にはもう兆候です。

現在、~/.claude/skills/には7つのディレクトリがあります。build-masterskaya-guide、build-vc-spoke、build-reel-script、build-practicum-instruction、update-config、simplify、keybindings-helpです。最も頻繁に使うのはbuild-masterskaya-guideです（このガイドもそれを使って書きました）。中には34 KBの方法論があり、進めるべき段階、実行すべきマルチエージェントQAチェック、処理を止めるゲート条件、/tmp/に保存する成果物を定めています。

skillを作るべきでない場合。

• 「ユーザーの希望する言語で回答する」のようなルールは、skillではなくCLAUDE.mdに記載します。skillは起動時に読み込まれますが、このルールは常に適用すべきです。
• 「今すぐリファクタリングを実行して」のような一度限りの指示は、skillではなくチャットで伝えます。
• 別文脈が必要ならsubagentを使い、反復手順もあるなら、その方法論をskillへ保持します。

主なアンチパターン。 vibe coderによくある間違いは、本来skillにすべき手順をsubagentに詰め込むことです。subagentは独自のコンテキストを持つため、より多くのトークンがかかり、起動も遅く、過剰なことがよくあります。外部ファイルを読まずに、方法論を1,500〜2,000語にまとめられるタスクならskillです。

skillの構成方法、frontmatterに入れる内容、効果的なトリガーフレーズについては、Claude Code Skills in 2026: How to Build a Personal Skills Libraryのガイドをご覧ください。

skillではなくsubagentが必要なのはどんなときか？#

skillは方法論を保存し、subagentは作業を行います。どちらも「チャットから」起動するため混同されがちですが、異なるレイヤーです。

subagentを使う意味があるのは、コンテキストを隔離する場合だけです。メインのClaudeセッションの予算は200,000トークン（ベータ版では100万）です。メインチャットに30個のファイルを読んでそれぞれ分析するよう頼むと、中間的な読解だけでウィンドウの半分を消費します。subagentは別セッションで同じ作業をし、結果だけをメインチャットに返します。

具体的なプロジェクト例。 すべてのガイドでは、スタイル、一次資料に照らした引用と事実、検索エンジン向けの構成、内部リンクと外部リンクの整合性について、いくつかのQAチェックを並行して行います。それぞれのチェックには独自のコンテキストが必要です。ルールの用語集、数十個のURLへのWebFetch、テキスト全体のgrepなどです。

これらのチェックをすべて1つのチャットで実行すると、最初のチェックが終わる前にコンテキストがあふれてしまいます。run_in_background: trueでsubagentを並列実行すれば解決できます。subagentがバックグラウンドで作業している間にメインチャットを進められ、4〜6分後には簡潔なレポートを受け取って修正を適用できます。

2つ目の例――大規模な調査。 新しいガイドのテーマを選ぶとき、4つのsubagentが並行して情報を集めます。

• V1 - 14日分のフォーラムやコミュニティ
• V2 - ソーシャルネットワーク
• V3 - 動画プラットフォーム + Anthropicブログ
• V4 - SEOのギャップ

それぞれが、話題性スコア付きの項目を30〜40件返します。それらをまとめて9つの観点から重み付けし、最も有望なものを選びます。subagentを使わない場合、この段階でメインのコンテキストを消費しながら2〜3時間かかります。

subagentを作るべきでない場合。

• ファイルを読むこともWebFetchを使うことも必要ないタスクは、メインチャットで行います。
• 反復手順はskillへ置き、隔離が有用なら子の中で実行できます。
• 外部アクセスにはMCPやCLIなどの認可ツールが必要で、子へ委任して使わせることもできます。

主なアンチパターン。 Claudeが使いどころを判断してくれると期待して、backend-engineerやqaという名前のsubagentを作ることです。migration-test-writerやapi-route-reviewerのような具体的なsubagentのほうが、はるかに高い品質になります。名前と指示が具体的であるほど、Claudeは適切なものを正確に選べます。

特定タスク向けsubagentの作り方、frontmatterの構文、すぐ使える5つの例については、Claude Code Subagents in 2026: A Step-by-Step Guideをご覧ください。

skillやsubagentではなくMCPが必要なのはどんなときか？#

Anthropicはブログ記事で違いを最短の表現にまとめています。MCPはClaudeをデータにつなぎ、skillsはそのデータを使って何をするかをClaudeに教えます。

GitHub issueレビューのスキルには、その内容が必要です。認可されたMCP、CLI、渡した文章などで提供し、スキルで検討と指摘の形式を定めます。MCPのアクセスだけでは手順は決まりません。

私が実際に使っているMCP構成。

• Playwright MCP - すべてのガイドのビジュアルQA。デスクトップとモバイルでページを開き、コンテナの幅やブロックが表示されたかを確認します。
• Stitch MCP - デザインシステムへのアクセスと、ブランドスタイルに沿ったコンポーネントの生成。
• vidIQ MCP - トレンド分析とアイデアの話題性チェック。
• Railway MCP - デプロイ用インフラの管理。

この4つはどれも、外部システムへの橋渡しです。MCPがなければ、自分でラッパーコードを書くか、ブラウザーに切り替えることになります。MCPを使えば、すべてClaudeのセッション内で完結します。

トークンコスト。 MCPは最も高価なレイヤーです。接続したサーバーはそれぞれ、ツール宣言、引数のスキーマ、説明文によってコンテキストウィンドウの領域を常に使います。私はMCPサーバーを4つ使っているので、何も尋ねる前から各新規セッションで約8〜12Kトークンを消費します。

つまり、ほとんどのセッションで実際に必要な場合に限ってMCPを接続します。Sentry MCPを週に1度しか使わないなら、常時有効にするより、--mcp sentryフラグで必要なときに有効化するほうがよいでしょう。

MCPを使うべきでない場合。

• 「データの扱い方」に関する方法論は、MCPではなくskillに入れます。
• 長い読解は子へ分けると役立つ場合があり、外部ファイルや記録なら、その子にMCPも必要なことがあります。
• 1つのコマンドで公開するなら、MCPではなくhookかpluginを使います。

主なアンチパターン。 skillで対応できることにMCPサーバーを作ることです。ある公開議論で、「コードレビューの指示」を提供するMCPサーバーを作った例を見ました。しかし、それは外部へのアクセスではなく手順です。skillなら同じことをより少ないトークンでできます。

リソース競合の事例。 以前、Playwright MCPが「Browser is already in use」というエラーで停止したことがあります。同時にChromeのウィンドウを開いていたため、MCPがブラウザーを操作できなかったのです。ここから得られる大切な教訓は、MCPサーバーはシステムリソースを共有するということです。ブラウザー、ポート、ファイルなどのリソースが競合するなら、最初から隔離を検討してください。

すぐに使える7つのMCPを接続するガイドは、Claude Code MCP Servers in 2026: 7 Ready-to-Use Setupsにあります。

skillやsubagentではなくpluginが必要なのはどんなときか？#

Skills、subagents、MCPは自分の方法論を扱います。pluginは誰かが用意した方法論を、自分の環境に取り込むものです。

2025年10月、Anthropicは公式の配布手段としてClaude Code Pluginsを開始しました。pluginは、次のものを含められるディレクトリです。

• 独自のスラッシュコマンド
• 独自のskills
• 独自のsubagents
• 独自のhooks
• 独自のMCP設定
• 独自の出力スタイル

これらすべてをplugin.jsonで1つのバンドルにまとめます。インストールは~/.claude/settings.jsonへの1行追加、または/plugin install <name>コマンドで行います。

私が実際に使っているplugin構成。

• frontend-design。公式のclaude-plugins-officialから利用します。67種類のスタイル、96種類のパレット、57種類のフォントの組み合わせ、13種類のフレームワークがあります。サイトの新しいブロックやメールテンプレートを作るとき、このpluginを読み込めばライブラリ全体を一度に使えます。
• playwright。同じ公式マーケットプレイスから利用する、ブラウザーテスト用のskillsとMCP設定のセットです。
• telegram。Claude CodeからTelegramアカウントを管理する既製のセットです（ポリシー、許可リスト、ペアリング）。
• trailofbits/skills。セキュリティ面で信頼しているTrail of Bits社のセキュリティ用skillsのセットです。

この4つはsettings.jsonの3行に収まります。pluginがなければ、同じライブラリを手作業で作るのに何時間もかかるでしょう。

pluginを使うべきでない場合。

• 方法論が完全に自分独自のもので、他の人に広げる予定がないならskillのままにします。
• 誰が使うのかまだわからないなら、まず自分用のskillとして試します。
• 新しいマシンに3つのファイルをすぐ移したいだけなら、cp ~/.claude/skills/X /new/machine/.claude/skills/でできます。

主なアンチパターン。 CLAUDE.mdの代わりにpluginを使うことです。たとえば、「このプロジェクトではこうする」というルールを含むpluginなどです。pluginは配布と再利用を目的にしています。1つのリポジトリだけに適用するルールは、pluginではなくCLAUDE.mdに記載します。

2026年を見据えると、Anthropicはplugin向けのチームマーケットプレイスへ明らかに進んでいます。企業が社内の方法論をpluginとして公開し、バージョン管理して、1つのコマンドですべての従業員に更新を配布できるようになるということです。個人事業主にとっては、使えるものをインストールし、作り直さないという意味です。

判断ツリー：タスクの前に確認する4つの質問#

質問1：残す価値のある反復手順か？

必要ならskillとしてSKILL.mdへ方法論と使用条件を記録します。手順を与えますが、外部アクセスや独立文脈を自動で与えるものではありません。

質問2：別文脈や、絞った担当役が必要か？

必要ならsubagentへ具体的な仕事とツールを渡します。隔離した中でスキルの方法論に従うこともできます。

質問3：ツールや外部データが必要か？

必要ならMCPや適切なツール、設定済みCLIなどで許可されたアクセスを与えます。スキルは使い方を説明し、委任した子が実行役にもなれます。

質問4：この設定をパッケージで配布・保守するか？

必要ならpluginでスキル、エージェント定義、フック、MCP設定を配布します。自作でも別の作者のものでも構いません。

組み合わせ例：定期的なGitHub issueレビュー。 スキルが手順と結果形式、設定済みGitHub MCPかCLIが認可されたデータを提供し、子が長いスレッドを別文脈で読んで指摘を返します。プラグインで全体をチームへ配布できます。4つすべてが「はい」でも矛盾しません。

vibe coderが犯す、レイヤー選択の5つの間違い#

一緒に仕事をするvibe coderたちに、私はこの5つのパターンを毎週見かけます。そのうちの2人に1人は、最初の週に少なくとも1つをやってしまいます。

間違い1：skillの代わりにsubagentを使う。

症状：ある作者が「新しいブログ記事を書く」ためのsubagentを作りました。subagentを実行するたびに、起動し、2 KBの方法論を読み、記事を生成して終了します。1週間後、作者はsubagentの読み込みだけで実行ごとに余分な5Kトークンを消費していることに気づきます。

どうすべきか：「記事の書き方」は方法論なので、skillにします。トリガーは「新しいブログ記事」というフレーズです。skillはメインチャットに読み込まれ、別セッションを開きません。3〜5倍安く済みます。

間違い2：skillの代わりにMCPサーバーを使う。

症状：ある作者が「コードレビューの方法」を教えるMCPサーバーを書きました。ツール宣言、引数スキーマの説明、ドキュメントがコンテキストを占有し続けます。各リクエストで、何の役にも立たないのに2〜3Kトークンが無駄になります。

どうすべきか：「コードレビューの方法」は手順であり、外部システムへのアクセスではありません。skillを使います。たとえばSentryから最新のエラーを取得するなど、ライブアクセスが必要な場合に限りMCPが適しています。

間違い3：CLAUDE.mdの代わりにpluginを使う。

症状：ある作者が「TypeScriptのstrictモードを常に使う」「ダッシュを使わない」「npmではなくpnpmだけを使う」などのプロジェクトルールをpluginにまとめてインストールしました。これで各新規セッションが、CLAUDE.mdに書くべき内容と重複するpluginを読み込むようになりました。

どうすべきか：1つのプロジェクトのルールは、そのプロジェクトのCLAUDE.mdに記載します。pluginは、複数の人やリポジトリに広げる方法論に使います。

間違い4：hookを使ってskillを作ろうとする。

症状：ある作者は、hookがイベント時（例：ファイルの保存前）に自動実行されることを知りました。そこで、あらゆる編集にClaudeが方法論を自動適用するよう、「hook経由のskill」を作ろうとしました。無限のトリガーループが発生し、コンテキストを浪費して、動作も予測できなくなりました。

どうすべきか：hookは、コマンドを実行したり、結果を整形したり、操作をブロックしたりする決定論的なコードです。hookはskillを読み込んだり、Claudeを呼び出したりしません。「方法論Xを常に適用」する必要があるなら、トリガー付きのskillか、CLAUDE.mdの項目を使います。

間違い5：何も必要ないのに、余計なレイヤーを加える。

症状：ある作者がskillの話を聞いてガイドを読み、「この方法論をパッケージ化する必要がある」と判断し、月に1度しか行わないタスクのために一晩かけてskillを作ります。

どうすべきか：一度限りのタスクは、その都度チャットで行います。skillが適しているのは、1日に複数回行う場合です。そうでなければ、後で保守が必要になる過剰設計です。

手順、文脈・役割の隔離、ツールアクセス、配布の必要性を独立に確認します。具体的な目的のある層を加え、複数必要なタスクでは組み合わせてください。

Anthropicが語るレイヤーの分断：2026年にClaude Codeはどこへ向かうのか#

今後6か月から1年で何が起こるでしょうか。

第一に、skillsが手順的なタスクの中心レイヤーになりつつあります。 Anthropicは、最も安価で予測しやすいレイヤーとして、明らかにskillに賭けています。2026年にskillがなぜ必要なのかわからないなら、まず学んでください。他のすべてのレイヤーはskillを中心に動くようになります。

第二に、subagentsは専門化しています。 subagentの主な役割は、重いタスクでコンテキストを隔離することです。qa-engineerのような汎用subagentはなくなり、migration-test-writerやapi-route-reviewerのような具体的なものが残るでしょう。

第三に、Anthropicが14日間で発表した新機能、つまり多数のsubagentを統括する/workflowsコマンド（2026年5月28日）と、2026年6月15日から始まるAgent SDKの請求分離は、プログラムからの利用が別の枠へ移行していることを示しています。 Anthropicは、個別のセッションではなく、10以上のエージェントを使う自動システム向けのインフラを構築しているという兆候です。

2026年のvibe coderにとって、これは単純なことを意味します。4つのレイヤーは少なくともあと6か月は残り、その後いくつかが統合されるでしょう。ただし、4つの質問による判断ツリーは統合後も使えます。特定のレイヤー名ではなく、タスクの性質に基づいているからです。

すぐ使えるマトリクス：よくある10のタスクと適切なレイヤー#

この表を使うときの大原則は、「10個すべてを一度に」やろうとしないことです。個人で作業するvibe coderの大半は、CLAUDE.md + 5〜7個のskills + 2〜4個のMCPサーバーで足ります。プロジェクトの成長に合わせてsubagentsやpluginsを追加します。

次は何をするか：Claude Codeの作業環境を整える#

これら5つのレイヤーは順番に並ぶのではなく、互いに組み合わさります。CLAUDE.mdがプロジェクトの土台となり、タスクの広がりに応じて他の4つがつながります。

Ailootについてご覧ください。