スキル探索のコストを9割削る、AIマップの作り方

メルマガ登録特典

スキル探索のコストを9割削る、
AIマップの作り方

Anthropic公式ガイド準拠　｜　Claude Code対応　｜　設定時間約10分

90〜95% コスト削減

XやYouTubeで「便利なスキルを見つけた」という投稿を見て、どんどんスキルを追加していませんか？　気づけば10個、20個、30個……。その「スキルを増やす行為」が、AIの精度とコストを静かに壊しています。

Anthropicの公式ガイドが警告していたこと

2026年1月29日に公開された「The Complete Guide to Building Skills for Claude」には、こんな記述があります。

"Evaluate if you have more than 20-50 skills enabled simultaneously"

同時に20〜50以上のスキルが有効になっていないか確認してください

なぜ問題が起きるのか

AIエージェントはスキルを使うとき、「どのスキルが今の作業に関係あるか」を判断するために、登録されているスキルの説明文を全部読み込みます。スキルが5個のときは大した量ではありませんが、30個・50個になると毎回大量のテキストを読み込むことになります。

AIが読み込む量が増える
余計な情報が混ざって回答精度が落ちる
動作が遅くなる

日本語トークン消費（主要AI比較）

AI	1文字あたりのトークン消費
Gemini	約 0.9〜1.0 トークン
GPT	約 1.1〜1.2 トークン
Claude	約 1.3〜1.4 トークン（主要AIの中で最多）

Claudeは日本語のトークン消費が主要AIの中でもっとも多いモデルです。スキルのムダ読みが、他のAIより直接的に速度とコストに影響します。

公式ガイドが示す3つの警告

スキルを増やしすぎると全部読み込んで重くなる
説明文が曖昧だと関係ない場面でも勝手に起動する
スキルの中身が肥大化するとそれ自体がコストになる

スキルを増やすほど、AIが賢くなるどころか、逆に鈍くなっていく。これが「スキル増加の罠」です。

実際の効果（スキル80個の環境）

読み込みコスト：40,000〜60,000 トークン　→　2,000〜3,000 トークン
削減率約90〜95%　｜　設定時間約10分

解決策は「マップ1枚」を置くこと

AIとスキルの間に「マップファイル」を1枚置くだけで解決できます。マップファイルとは、全スキルの「名前」と「何に使うか」だけをまとめた一覧表です。本でいえば「目次」です。

AIはマップを見るだけで「今回必要なスキルはこれだ」とピンポイントで特定し、そのスキルだけを読みに行くようになります。スキルが50個でも100個でも、毎回読み込むのはマップ1枚＋必要なスキル1〜2個だけ。スキルが増えても、コストも精度も変わらない状態になります。

マップファイルの作り方（2ステップ）

AIにマップを作らせる

以下のプロンプトをそのままAIに渡してください。スキルの内容を読み込み、カテゴリー分類からマップ作成まで一度に完了します。

スキルフォルダ内のすべてのSKILL.mdを読み込み、内容を分析して
適切なカテゴリーに自動分類したマップファイルを
~/.agents/skills/SKILLS_MAP.md として作成してください。

【出力形式】
カテゴリーごとに、以下の形式で出力してください。

## カテゴリー名
| スキル名 | 説明 |
| :--- | :--- |
| `skill-name` | どんな場面で使うかを一行で |

※ ~/.agents/skills/ の部分はご自身のスキルフォルダのパスに合わせて変更してください。

マップを「先に読ませる」設定をする

マップファイルを作っただけでは、AIが自動で参照してくれるとは限りません。「作業を始める前にこのマップを読んでね」と設定に書いておく必要があります。

Claude Codeの場合、~/.claude/CLAUDE.md に以下を追加してください。

いかなるタスクに着手する際も、まず最初に SKILLS_MAP.md を読み込み、
最適なスキルを選択・活用すること。
新しいスキルを追加した際は、必ず SKILLS_MAP.md も同時に更新すること。

最初の一行でAIが毎回マップを先に確認するようになります。2行目を書いておくと、新しいスキルを入れるたびにAIが自動でマップを更新してくれます。手動で管理する必要がなくなります。

アーカイブ・大量ファイルへの応用

この仕組みはスキル管理に限りません。「大量のファイルをAIに参照させたい場面」であれば、どこでも同じ方法が使えます。300本を超えるメルマガ・note記事のアーカイブにも同じ方法を使っています。

マップ（ARCHIVE_MAP.md）を1枚置いてからは、AIはまずマップを読んで「この記事が関係しそう」と特定してから、そのファイルだけを開くようになりました。

アーカイブ用マップのプロンプト

archiveフォルダ内のすべてのファイルを読み込み、
以下のカテゴリーに分類した一覧表（ARCHIVE_MAP.md）を作成してください。

【カテゴリー】
- ○○○○（カテゴリ1）
- ○○○○（カテゴリ2）
- ○○○○（カテゴリ3）

【出力形式】
## カテゴリー名
（このカテゴリーの概要を一行で）
| No | タイトル | 要約 |
| :--- | :--- | :--- |
| #001 | ファイル名 | 内容の要約を一行で |

設定ファイルへの追記

過去の記事や関連情報の確認には、必ずARCHIVE_MAP.mdを参照すること。
ファイルを直接開く前に、まずこのマップで対象を特定すること。
新しい記事を作成した際は、必ずこのマップも同時に更新すること。

まとめ

スキルが20〜50を超えると、Anthropic公式も問題があると警告している
原因は「AIが毎回すべてのスキルを読み込む」挙動にある
マップファイルを1枚置くだけで、スキルが何個あっても問題にならない
同じ仕組みは、アーカイブ・ログ・大量ファイルの管理にも応用できる