Claude Code 技能悄然失效？這款 CLI 工具助你及早發現

你的 Claude Code 技能可能正在默默失效，而且沒有任何通知。每個你安裝的技能都會在每次互動時，將其名稱和描述注入模型的上下文視窗中，無論是否被使用。

Claude Code 將這個列表的預算設定為上下文視窗的 1%（skillListingBudgetFraction，預設為 0.01）。當列表溢出時，它會從你最不常用的技能開始，捨棄其描述。使用者介面中沒有任何警告，只有一條 --debug 記錄。

一個沒有描述的技能，模型就無法將你的請求與之匹配，因此它會悄悄地停止被選用。一項測量發現，一個完整的插件安裝會使列表超出預算約 10.8 倍，這意味著大部分目錄實際上是隱形的，卻沒有人被告知。

為了解決這個問題，我開發了一個命令列介面（CLI）工具，可以在問題發生前找出這些技能。skill-tax-cli 會審核你的 Claude Code 技能的上下文成本：它會掃描每個技能來源，測量每個技能的常駐列表成本和滿載成本（以 token 計算），並確定性地重現列表預算溢出規則，然後告訴你哪些技能會失去其描述。

它沒有任何依賴，只使用 Python 標準函式庫，你可以透過 pip install skill-tax-cli 安裝。

列出 Claude Code 可以看到的所有技能，包括使用者技能、專案技能和市集插件技能：

$ skill-tax-cli list

huge plugin:acme 236 listing / 1482 load tokens

proj project 6 listing / 16 load tokens

tiny user 6 listing / 16 load tokens

3 skill(s)

審核成本，依滿載成本排序，顯示其在上下文視窗中的佔比，以及其他常駐來源（規則、記憶體、MCP 配置）的總表：

$ skill-tax-cli audit --window 200000

skill source listing load load%window

huge plugin:acme 236 1482 0.74%

tiny user 6 16 0.01%

偵測悄然失效的技能，這是其他工具無法做到的部分。gate 會重現文件記載的溢出規則（最不常用的技能會首先失去其描述），並在技能會被悄悄移除時，以非零的結束代碼失敗：

$ skill-tax-cli gate --window 200000

SILENT-DROP RISK: 2 of 34 skill(s) exceed the 2000-token listing budget:

- huge [plugin:acme] desc ~230 tokens, usage = 1 -> description would be silently stripped

- helper [user] desc ~88 tokens, usage = 0 -> description would be silently stripped

$ echo $?

1

結束代碼 0 表示正常，1 表示有悄然失效的風險，2 表示配置錯誤，每個指令都有 --json 選項，因此可以直接整合到 pre-commit hooks 和 CI/CD 流程中。傳遞 --usage usage.json（例如 {"skill-name": invocation_count}）可以重現你的實際使用情況，而不是使用預設的回退機制。

為什麼需要另一個技能審核工具？因為它是唯一一個 CI 友善且確定性的工具。官方的 /skill-doctor 和我找到的每個社群 skill-doctor 都是互動式的，它們會在會話中顯示報告。而這是一個帶有穩定結束代碼的純 CLI 工具，專為自動化流程而設計。

其核心價值在於靜默排除偵測。文件描述了 1% 的預算和最不常用優先的捨棄順序，但沒有工具能重現這個規則來告訴你哪些技能即將失效，現在有了。

這個 CLI 工具能處理所有常駐來源。技能、CLAUDE.md 規則、MEMORY.md 和 MCP 配置都可以一起測量，提供每次互動的完整成本，而不是需要四個不同的工具。Token 計算方式是誠實的：round(chars / 4)，這與我的 mcp-tax 工具用於 MCP 伺服器 schema 的計算方式相同。

這是一個數量級的估算，而非計費儀表，但足以回答「哪個技能正在消耗我的視窗？」這個問題。

連結：GitHub · PyPI。10 個煙霧測試都通過了，包括預算模擬和 gate 結束代碼。如果你的技能庫已經多到「我記得我安裝過那個」的程度，請執行 skill-tax-cli gate，你可能會發現一半的目錄已經失效了。