結論：/skill-doctorで未使用Skillを見つけ、削除はowner確認後に行う
Claude Code 2.1.261で追加された/skill-doctorは、読み込まれているSkillsのうち使われていないものと、コンテキストでどれだけコストを使っているかを確認するための診断機能です。結果を見て即削除するのではなく、利用実績、owner、scope、代替手順を確認して整理します。
読者の困りごとは、project、personal、enterprise、plugin、同期Skillが増え、どの指示が候補として読み込まれ、長い説明が毎回の判断を重くしているか分からないことです。この記事の目的は、Skillを8手順で棚卸しし、残す・短くする・scopeを移す・無効化する判断を証跡付きで行えるようにすることです。
最初に一つのrepositoryで/skill-doctorを実行し、出力を共有チャンネルへそのまま貼らず、Skill名、source、owner、判断だけを台帳へ転記します。Skill本文や動的入力に機密情報がある場合は、診断結果の共有範囲もレビュー対象です。
2.1.261で何が変わったか
Claude Code公式CHANGELOGの2.1.261（2026年9月4日）には、/skill-doctorが追加されました。読み込まれたSkillsのうち未使用のものと、そのSkillがコンテキストで消費する量を示し、不要なSkillを整理できる機能です。これはSkillの内容が正しいかを自動承認する機能ではなく、利用状況と負荷を棚卸しする入口です。
公式Skills guideでは、Skillの本文は使う時に読み込まれ、CLAUDE.mdのように常時読み込まれる事実と役割が違うと説明されています。一方、Skillのdescriptionや候補情報は発見に影響します。未使用と表示されたから安全でない、使用中だから適切、とは言えません。頻度とリスクを別の列に持ちます。
また、同じ名前のSkillはenterpriseがpersonalより、personalがprojectより優先されます。pluginはnamespaceを持ち、同期Skillは別の供給源です。診断前にsourceを分けないと、project側だけ修正しても実際に呼ばれるSkillが変わらないことがあります。
結果を4分類で読む
| 診断後の状態 | 判断 | 次の行動 |
|---|---|---|
| 未使用・低リスク | 保留または無効化候補 | ownerと代替手順を確認し、期限を決める |
| 未使用・高リスク | 本番scopeから隔離 | tool、動的入力、権限を確認して再評価 |
| 使用中・高負荷 | 短縮・分割候補 | 事実をCLAUDE.mdから分離し、必要時だけ読む |
| 使用中・低負荷 | 継続候補 | version、owner、評価ケースを記録する |
「未使用」は、最近のセッションで呼ばれなかったという観測です。四半期業務や障害対応のSkillまで消すと、必要な時に再発見できません。使用頻度、失敗時の影響、scope、復元容易性を合わせて決めます。特にdeploy、権限変更、外部送信を含むSkillは、未使用でも低リスクとは扱いません。
/skill-doctorを安全に使う8手順
- 対象のClaude Code versionが2.1.261以降か、
claude --versionで記録します。 - 対象repository、session、project scopeを固定し、本番作業中ではなく点検用sessionを開きます。
/skill-doctorを実行し、出力のSkill名と負荷を台帳へ転記します。- enterprise、personal、project、plugin、syncedのsourceと優先順位を照合します。
- 各Skillのowner、最終更新、対象業務、利用頻度、外部toolの有無を確認します。
- 未使用でも残す期限付きSkillと、無効化してよいSkillを分けます。
- 高負荷Skillは、事実・手順・動的入力・禁止操作を分解し、必要時だけ読む形へ直します。
- 小さな代表taskで再実行し、期待するSkillが選ばれ、出力と権限が変わらないことを記録します。
無効化は削除より先に行います。projectの設定やpluginの有効化を変更する場合は、変更前のcommit、対象scope、rollback方法を残します。Skillが複数のrepositoryで使われる場合、単一projectの成功だけで全社展開を判断しません。
コンテキスト負荷と料金を混同しない
/skill-doctorが示すコンテキスト消費は、Skillの説明や本文が判断に与える負荷を整理するための指標です。Anthropic公式PricingやClaude Codeの利用条件は別に確認し、診断表示をそのまま請求額と断定しません。モデル、effort、入力、出力、cache、sessionの利用量が費用へ影響します。
改善の順番は、まず重複した説明を削り、次に常時必要な事実と手順を分離し、最後にモデルやpromptを変えることです。Skillを短くし過ぎて禁止操作や検証条件が消えると、見かけの負荷は下がってもリスクが上がります。短縮後は、成功条件、失敗時停止、human reviewを必ず再テストします。
棚卸しチェックリスト
versionを記録したか／対象scopeを固定したか／Skillのsourceとownerが分かるか／未使用と危険性を別々に評価したか／外部toolと動的展開を確認したか／高負荷の理由を説明できるか／短縮後の禁止事項が残っているか／無効化前にrollbackを用意したか／代表taskで再実行したか／次回点検日を決めたか、を確認します。
Skillの出所と優先順位はClaude Code Skillsの安全管理、権限と承認はClaude Codeの権限ガイド、更新の統一は更新経路とrelease channelも参照してください。診断コマンド単体では、組織の変更管理は完成しません。
台帳には診断日、Claude Codeのversion、source、scope、Skillのcommit、利用頻度、負荷、リスク、判断者、次回確認日を残します。これで「使われていないから削除した」という短絡を避け、後から業務ownerが必要性を再評価できます。更新は小さな代表taskで差分を読み、出力だけでなく拒否すべき操作も確認します。
よくある質問
/skill-doctorはSkillを自動削除しますか？
この記事で確認した公式CHANGELOGの説明は未使用Skillとコンテキスト負荷の表示です。削除や無効化はownerとscopeを確認して人が判断します。
未使用Skillは不要ですか？
不要とは限りません。月次・障害対応など低頻度でも重要な手順があります。利用頻度、影響度、復元性を合わせて保留期限を決めます。
2.1.261へ全員すぐ更新すべきですか？
新機能だけで一斉更新を決めず、現在のinstall方法、channel、managed settings、代表Skillを確認して段階展開します。
公式情報と無料診断
仕様と正式な提供条件は、公開直前に公式CHANGELOG、Skills guide、Settingsをreadbackしてください。Miraigentの無料診断では、Skill、権限、owner、評価、費用、rollbackを一枚に整理します。