この記事のポイント
- /skill-doctorは未使用のSkillsとコンテキスト消費量を表示する診断機能です。
- 表示結果は現在のセッションでの使用状況。別の仕事で必要なSkillもあります。
- 不要・重複の候補を見つけ、削除前に利用目的と呼び出し条件を確認します。
Claude Codeの変更履歴をもとに、/skill-doctorが表示する情報と使い方を整理します。未使用という結果を、そのまま削除指示と捉えないための見方も説明します。
未使用Skillsとコンテキスト消費を確認
公式チェンジログの説明はシンプルです。
Added
/skill-doctorto show which loaded skills go unused and what they cost in context, so you can prune them
つまり表示されるのは、今のセッションで実際には呼び出されていない「未使用スキルの一覧」と、各スキル(特に未使用のもの)がコンテキストウィンドウでどれだけトークンを消費しているかを示す「コンテキストコスト」の2点です。「便利そうだから」と読み込んだスキルが、実は一度も使われずにコンテキストだけを食べていた——ということが、感覚ではなく数字で確認できるわけです。
使い方はコマンド1つ、整理の目安
Claude Codeのセッション内で/skill-doctorと入力するだけで、未使用スキルとそのコンテキストコストが表示されます。特別な設定や事前準備は不要で、思い立ったときにすぐ確認できます。目的は、不要なスキルを見つけて「プルーニング(剪定)」することです。セッションが長くなるほど読み込んだままのスキルがコンテキストを圧迫しやすくなるため、会話が長くなり応答が重く感じるとき、プロジェクトを切り替えたのに前のプロジェクト用のスキルが残っている気がするとき、スキルを増やす前に今の使用状況を点検したいときに試してみるとよさそうです。コンテキストは有限のリソースなので、「入れっぱなし」を定期的に見直す習慣を作れる点が実務的な価値だといえます。
まとめ
Skillsを管理する方は、診断結果とSkillの用途・呼び出し条件を照らすとよいでしょう。今のセッションで使われなくても、別の作業には必要な場合があります。重複や古い手順を整理した後、必要な場面で呼び出せるかを確認できます。
※ 2026年9月時点の情報です(v2.1.261)。最新の仕様は公式チェンジログで確認するとよいでしょう。
複数のマシンで動くAIエージェント同士を連携させたい場合はClaude Code、別マシンのAIエージェント同士を連携する新機能が参考になります。PCを閉じてもセッションを継続したい場合はClaude Codeのクラウド実行が正式リリース、閉じてもそのまま動くもあわせてどうぞ。
