メインコンテンツへスキップ
       

Claude Code・Codexのスキルが増えすぎたときの整理方法―トークン消費,誤起動及び段階的読込み(AI作成)

第1 結論

1 スキルの数だけでなく,読み込まれる範囲を確認する

Claude CodeやCodexで使うスキルが増えたときは,ファイル数を一律に減らすのではなく,①最初からモデルに示される名前・説明,②選ばれたときに読むSKILL.md,③必要な場合だけ読む参照資料・スクリプトを分けて見直すことが重要である。
常時読み込まれる短い情報が重なれば,全ての作業でコンテキストを使う。
説明の範囲が重なれば,関係の薄いスキルが選ばれ,長い本文や参照資料まで読み込まれる原因になる。

したがって,よく使う作業は短く具体的な入口から必要な資料だけへ案内し,まれに使う重い作業は手動で明示的に呼び出す構成が基本になる。
もっとも,一次資料の確認,機密情報の取扱い,外部への送信・公開の承認及び結果の読戻しは,トークン節約を理由に省略してはならない。

2 本記事の範囲と確認日

本記事は,スキルの数が増えたときの整理方法を,公開されているOpenAI及びAnthropicの公式資料に基づいて説明するものである。
特定の利用者のスキル数,トークン量,PCのパス又は社内の構成は掲載しない。
製品仕様の確認日は令和8年10月26日であり,設定名や読み込み方は変更されることがあるため,実施時には最新の公式資料を確認する必要がある。

第2 スキルが読み込まれる3段階

1 名前と説明

OpenAIのSkills公式資料では,スキルの名前と説明が先にモデルへ示され,利用者の依頼と合うスキルを選ぶために使われる。
OpenAIは,スキルが多い場合や説明が長い場合には一覧が短縮されることがあり,説明の重複は関係の薄いスキルの読込みにつながると説明している。

Anthropicも,Agent Skillsについて,最初は名前と説明を読み,必要になったときにSKILL.mdへ進む段階的な仕組みを説明している。
このため,説明文は単なる紹介ではなく,どの依頼で選び,どの依頼では選ばないかを決める入口である。

2 SKILL.mdの本文

SKILL.mdには,作業の順序,入力,成果物,停止条件及び確認方法を置く。
本文を短くすること自体が目的ではなく,その作業を安全に進めるために毎回必要な規則を残し,個別の場合にしか使わない説明を外へ分けることが目的である。

Claude Codeでは,自動選択を無効にして利用者が明示したときだけ呼び出す設定も用意されている。
破壊的操作,外部公開,本番更新又は利用頻度の低い管理作業は,名称だけが似た依頼から自動的に選ばれないよう,手動呼出しを検討できる。

3 参照資料とスクリプト

長い様式,分野別の資料,例外処理,検査スクリプト及び過去の事例は,必要なときだけ読む補助ファイルへ分ける。
SKILL.mdには,どの条件でどの資料を読むかを短く書き,関係のない参照フォルダを最初から全部読ませない。

段階的読込みは,資料を削除することではない。
必要な根拠や検査器を保持したまま,通常の依頼では入口だけを読み,該当する作業で初めて詳細へ進む設計である。

第3 スキルが増えすぎたときに起きる問題

1 常時のコンテキスト負担

名前と説明が常時示される仕組みでは,個々の説明が短くても,数が増えれば全ての依頼に共通する負担が増える。
同じ注意を複数の説明へ繰り返すと,入口の段階で重複が生じる。

2 誤起動と競合

「調査する」「文書を作る」「ブログを更新する」のように範囲が広い説明が複数あると,一つの依頼に複数の候補が当たりやすい。
調査だけの依頼に本番更新のスキルが選ばれれば,不要な手順を読むだけでなく,権限や停止条件の判断も複雑になる。

3 無関係な参照資料の読込み

入口から多数の参照資料を一律に読む構成では,今回使わない制度,ツール又は例外の説明までコンテキストへ入る。
必要な一次資料の確認と,関係のない補助資料の一括読込みは別である。
前者を維持しながら,後者を条件付きにする必要がある。

第4 ゼロベースで整理する手順

1 実際の作業単位で棚卸しする

最初に,スキルを名称ではなく実際の作業で分ける。
例えば,公開資料の調査,原稿の作成,本番更新,保存後の検証及び障害復旧は,似た記事を扱っていても必要な権限と停止条件が異なる。

各スキルについて,①対象となる依頼,②対象外の依頼,③毎回必要な規則,④必要時だけ読む資料,⑤外部へ影響する操作の有無を一覧にする。
利用実績がなく役割も重なるものは,統合又は保管を検討する。

2 入口の説明を短く一意にする

説明文には,対象,代表的な依頼及び対象外を簡潔に書く。
安全規則や詳しい手順を全て説明へ移すのではなく,別のスキルと区別するために必要な語を残す。

似たスキルがある場合は,「調査・起案まで」「本番反映だけ」のように境界を明示する。
一つの万能スキルへ全作業を集めると本文が重くなり,逆に細分化しすぎると説明の競合が増えるため,入力,権限及び成果物が変わる境界で分けるとよい。

3 軽いルーターから1件だけ選ぶ

分野別のスキルが多い場合は,短いルーターで依頼を分類し,必要なスキルを原則として1件だけ選ぶ構成が考えられる。
ルーター自体に各分野の詳しい手順を複写せず,選択基準と移動先だけを置く。

複数のスキルが本当に必要な場合は,調査,起案,検証又は本番反映の順序を決める。
同じ注意を全スキルへ複写するより,共通の安全規則を短い上位規則に置き,作業固有の手順だけを各スキルへ残す方が更新漏れを減らしやすい。

4 重い作業を手動呼出しへ移す

利用頻度が低く,誤起動した場合の影響が大きいスキルは,手動呼出しを検討する。
Claude Codeでは,自動選択を無効にすると説明も通常のコンテキストから外れるため,常時の負担と誤起動の双方を抑えられる。

ただし,手動呼出しにしたことだけで安全になるわけではない。
公開,送信,削除,上書き及び認証情報の利用には,別に権限の制限,人の確認及び保存後の読戻しを置く必要がある。

第5 品質を落とさずにトークンを減らす

1 削ってよい重複と残すべきゲートを分ける

削減の対象は,複数箇所に重複した説明,今回と無関係な事例,常時読む必要のない長い様式及び無条件の参照読込みである。
一次資料の確認,引用と要約の区別,未確認事項の表示,外部操作の承認及び結果の検証は残すべきゲートである。

2 検証結果を再利用する条件を固定する

同じ検査を毎回やり直さないことも,利用量の削減になる。
もっとも,再利用できるのは,原稿,根拠資料,検査器,資料の版及び検査条件が同じ場合に限る。
本文又は重要な命題が変わったときは,影響する部分を再確認する。

3 トークン量以外の指標も見る

評価では,①一覧として常時示される情報量,②目的のスキルが選ばれた割合,③無関係なスキルが選ばれた件数,④実行時に追加で読んだ資料量,⑤成果物の修正回数,⑥停止条件が働いたかを分けて記録する。
トークンが減っても,誤ったスキルの選択や手直しが増えれば,全体の費用と時間は減らない。

第6 見直し後の確認方法

1 代表依頼と非対象依頼で試す

各スキルについて,選ばれるべき代表依頼だけでなく,名称が似ているが対象外の依頼も試す。
調査専用スキルが本番更新の依頼を引き受けないか,本番更新スキルが調査だけの依頼で起動しないかを確かめる。

2 軽量化前後を同じ条件で比べる

同じ依頼,同じモデル及び同じ資料で,選択されたスキル,読んだ参照資料,入力トークン,所要時間及び修正回数を比べる。
一回の成功だけでなく,複数の代表依頼で誤起動と見落としがないかを確認する。

3 変更範囲を記録する

説明文だけを短くしたのか,本文を分割したのか,スキルを統合したのか,手動呼出しへ移したのかを分けて記録する。
他のPCや別の実行環境へ同期する場合は,ファイルの存在だけでなく,対象版と反映時刻を確認する。

第7 よくある質問

1 全てを一つのスキルにまとめるべきか

一つにまとめれば一覧の件数は減るが,本文が重くなり,異なる権限や停止条件が混ざることがある。
入力,成果物,権限又は検証方法が異なる作業は分け,単に題材が同じという理由だけで統合しない方がよい。

2 説明文は短ければ短いほどよいか

短すぎて選択条件が分からなければ,誤起動や未選択が増える。
対象と対象外を区別できる最小限の具体性を残し,詳しい手順を本文へ移すことが重要である。

3 スキルを減らせば429エラーは直るか

スキルの常時情報や不要な読込みを減らすと,将来の入力トークンや利用量を抑えられる場合がある。
しかし,既に到達したChatGPTプラン又はAPIの上限をリセットする方法ではない。
429エラーでは,エラーコード,課金経路,上限の単位及びリセット時刻を別に確認する必要がある。

第8 関連する山中弁護士ブログの記事

弁護士のClaude Code Skills活用法―調査・書面作成・記事更新を手順書にする(AI作成)は,法律事務所の作業をスキルへ整理する基本を扱っている。

生成AIの利用料が予算を超えないために―従量課金の約款で確認する5項目と社内規程の定め方(AI作成)は,利用量と費用を契約・社内規程から管理する方法を扱っている。

弁護士・税理士がAIエージェントのスキル・プラグインを導入するとき―付属スクリプト,外部送信,認証情報及び権限の確認(AI作成)は,軽量化とは別に維持すべきセキュリティ確認を扱っている。

Codexで429エラーが出る原因と対策-別IP・別PCで回避できるか(AI作成)は,利用上限とレート上限の切分けを扱っている。

第9 出典・参考資料

①OpenAI「Rethinking skills and prompts for GPT-6 Astra」(スキル一覧,説明文の重複及び段階的読込み)

②OpenAI「Skills―Plugins」(SKILL.md,名前・説明及び必要時の本文読込み)

③OpenAI「Skills tool」(Skillsの利用方法)

④Anthropic「Agent Skills overview」(メタデータ,SKILL.md及び補助資料の段階的読込み)

⑤Anthropic「Extend Claude with skills」(スキルの構成,手動呼出し,説明文の一覧及び補助ファイル)