【ITニュース解説】Your Claude Code skills are being silently demoted, and nothing tells you.

Claude CodeのようなAIアシスタントは、システムエンジニアが開発作業を効率化するために非常に有用なツールである。特定のタスクを実行する「スキル」をインストールすることで、AIに新たな機能を追加できる。しかし、実はこれらのスキルが開発者の知らないうちにその機能を失い、使えなくなってしまう「静かな無効化」という深刻な問題が存在することが報告されている。この現象は、開発環境で利用するツールやサービスの内部挙動を深く理解することの重要性を示している。

この問題の根源は、AIモデルがスキルを利用する際の内部的な仕組みにある。Claude Codeにスキルをインストールすると、そのスキルの名前と説明がAIモデルの「コンテキスト」と呼ばれる作業領域に自動的に書き込まれる。コンテキストとは、AIが現在の会話やタスクを理解し、適切な応答を生成するために参照する情報のことである。つまり、スキルが使えるようにするためには、AIがそのスキルの存在と内容を認識できる形でコンテキストに登録されている必要がある。

しかし、このスキルリストにはAIが一度に処理できる情報の量に限界があり、コンテキストウィンドウの約1%という「予算」が設定されている。この予算は「skillListingBudgetFraction」として知られ、デフォルトでは0.01（1%）である。インストールされたスキルの名前と説明がこの予算を超えてしまうと、問題が発生する。予算オーバーが検知されると、AIは自動的に、過去の使用頻度が低いスキルから順にその「説明」を削除していくのである。ここで重要なのは、スキル名自体は残っても、その説明が失われてしまう点である。

なぜ説明が削除されることが問題なのか。それは、AIモデルがユーザーのリクエストに対して適切なスキルを選択する際、そのスキルの「説明」を頼りにしているからだ。例えば、「このデータを分析してグラフを作成してほしい」というリクエストがあった場合、AIはコンテキスト内のスキル説明を読み、「グラフ作成」機能を持つスキルを探し出す。しかし、もしそのスキルの説明が削除されてしまっていたら、AIはそのスキルが何をするものなのか判断できなくなり、結果としてユーザーのリクエストに対してそのスキルを選択しなくなる。つまり、スキルは存在しているにもかかわらず、AIからは「見えない」、あるいは「利用できない」状態になってしまうのである。

さらに深刻なのは、このような無効化がユーザーに一切通知されない点である。Claude CodeのUIには警告が表示されず、唯一手がかりとなるのは開発者向けのデバッグログの奥深くにある一行のメッセージのみだ。そのため、開発者は自分がインストールしたスキルが突然機能しなくなっても、その原因に気づくことが非常に困難であった。実際に測定されたケースでは、特定のプラグインをインストールしたことで、スキルリストがデフォルト予算の約10.8倍にも膨れ上がり、結果としてほとんどのスキルがAIにとって実質的に「見えない」状態になっていたという報告がある。

このような「静かな無効化」の問題に対処するために、「skill-tax-cli」というコマンドラインインターフェース（CLI）ツールが開発された。このツールは、開発者がインストールしたスキルがコンテキストにどれだけの「税金（tax）」、つまり負荷をかけているかを監査し、どのスキルが説明を失うリスクがあるかを事前に教えてくれる。システムエンジニアにとって、開発環境の健全性を維持し、予期せぬトラブルを未然に防ぐことは非常に重要であり、このツールはそのための強力な味方となる。

skill-tax-cliは、非常にシンプルで使いやすいように設計されている。外部ライブラリに依存せず、Pythonの標準ライブラリのみで動作するため、簡単にインストールして利用できる。

このツールの主要な機能は以下の通りである。 まず、「list」コマンドを使うと、Claude Codeが認識しているすべてのスキル、すなわちユーザーが自分で作成したもの、プロジェクト固有のもの、そしてマーケットプレイスからインストールしたプラグインスキルを一覧表示できる。各スキルについて、コンテキストに常に登録されている「リスト費用」と、スキルが完全にロードされた場合の「フルロード費用」が、AIが処理する情報の最小単位である「トークン」で表示される。トークンとは、単語や記号の塊をAIが認識する単位であり、おおよそ4文字で1トークンとして計算されることが多い。

次に、「audit」コマンドは、さらに詳細な情報を提供する。このコマンドを実行すると、各スキルのフルロード費用がコンテキストウィンドウ全体に占める割合や、スキル以外の「常にオン」の情報源（AIのルール設定やメモリなど）がどれだけのコンテキストを消費しているかを示すテーブルが表示される。これにより、どのスキルが最も多くのリソースを消費しているかが一目でわかる。

そして最も重要な機能が「gate」コマンドである。このコマンドは、AIモデルの予算オーバーフローのルール（使用頻度の低いスキルから説明が削除される）を正確に再現し、どのスキルが「静かに無効化される」リスクがあるかを検知する。例えば、20万トークンのコンテキストウィンドウ予算に対し、2つのスキルが合計2000トークンのリスト予算を超過している場合、その2つのスキルが説明を失う可能性があることを具体的に警告する。この際、ツールの実行結果は成功（0）、サイレントドロップのリスクあり（1）、設定エラー（2）という終了コードで示されるため、開発の自動化プロセスであるCI/CDパイプライン（継続的インテグレーション・継続的デリバリー）に組み込むことが容易である。これにより、コードの変更や新しいスキルの追加が行われるたびに、自動的にスキルが無効化されるリスクがないかを確認できるのだ。

skill-tax-cliは、既存の他のスキル監査ツールとは異なる独自の強みを持っている。公式の「/skill-doctor」ツールやコミュニティが開発した同様のツールは、通常、対話形式でレポートを表示する。しかし、skill-tax-cliはシンプルにコマンドラインで動作し、安定した終了コードを提供するため、前述のCI/CDパイプラインのような自動化された開発フローに組み込むのに非常に適している。

また、このツールの最大の目的は、「静かな除外」を検出することにある。Claude Codeのドキュメントには、1%の予算や、使用頻度の低いスキルから説明が削除されるというルールが記載されているものの、実際にどのスキルが影響を受けるかを具体的に予測し、警告するツールはこれまで存在しなかった。skill-tax-cliは、この重要な情報を提供する唯一のツールである。

さらに、このツールはスキルだけでなく、CLAUDE.mdルール、MEMORY.md、MCP設定ファイルといった、AIモデルのコンテキストに常に影響を与えるすべての情報源をまとめて測定できる。これにより、開発者は個別のツールを複数使うことなく、AIモデルのコンテキストにかかる全体的な負荷を一度に把握できる。トークン計算は、「文字数 ÷ 4 を四捨五入する」という、実際の利用状況に近い概算方法を採用しているため、どのスキルがコンテキストウィンドウを「食いつぶしている」かを判断するのに十分な精度を持っている。

システムエンジニアとして、AIアシスタントを活用した開発を進める上で、その内部的な挙動を理解し、潜在的な問題を早期に発見する能力は非常に重要である。skill-tax-cliは、Claude Codeのスキルが開発者の知らないうちにその機能を失うという深刻な問題に対し、透明性と解決策を提供するツールである。もしあなたが多くのスキルをClaude Codeにインストールしており、どのスキルが使えているのか、あるいは使えていないのか把握しきれていないと感じるなら、このツールを試してみる価値は十分にある。多くのスキルがすでに「見えない」状態になっていることに気づかされるかもしれない。この知識は、AIを活用した開発をより効率的かつ安定的に進めるための第一歩となるだろう。