skill-audit：给你的 Claude Code Skill 树做一次体检

随着 Claude Code 的 Skill 生态不断壮大，很多人的 ~/.claude/skills/ 目录里已经堆了几十个技能。但你真的知道哪些在用、哪些已经"死了"吗？

skill-audit 就是为这个问题而生的。

它能查出什么

运行 /skill-audit 后，你会得到一份审计报告，涵盖以下四个维度：

• Inventory（盘点）：当前有多少 Skill、Hook、Alias
• Usage ranking（使用排名）：基于 ~/.claude/skill-usage.log 的真实调用次数
• Dead skill detection（僵尸 Skill）：连续 30 天零触发、无 Hook 绑定、CLAUDE.md 中也没有引用的 Skill，会被标记为归档候选
• Rule-execution gap（规则执行盲区）：这是最有价值的一项——你在 iron rules 里写了"遇到 X 必须触发 Y"，但实际上 Y 从来没跑过。规则写了等于没写。

一个真实的输出片段：

1
2
3
4
5

📈 Inventory: 61 skills / 4 hooks / 12 aliases
🔥 Top 5: session-end(262) / leo-style(182) / codex:rescue(119)
💀 Dead candidates (15): auto-dream / content-analyzer / ...
⚠️ Rule-execution gap (6 skills, 0 calls despite rule references):
   systematic-debugging — P0 rule "trigger on 3 consecutive failures", fired 0 times in 1388 invocations

安装与使用

1

git clone https://github.com/runesleo/claude-skill-audit ~/.claude/skills/skill-audit

然后在 Claude Code 中触发：

1

/skill-audit

或者直接说"run a skill tree health check"。

前置条件

工具本身无需 API Key，也不依赖外部服务，纯本地文件检查。但有一个关键前提：

需要配置一个 PreToolUse Hook，将每次 Skill 调用写入 ~/.claude/skill-usage.log。没有这份日志，usage ranking 和规则盲区检测就无从谈起。

此外，Skill 需要放在标准路径 ~/.claude/skills/ 下。

设计理念

skill-audit 不会自动删除任何东西。它只负责发现问题，决策权始终在你手里：

• 候选废弃的 Skill 移入 _archived/ 目录，观察 30 天，随时可以恢复
• 人工审核，不做自主清理

“Without Waza, this skill wouldn’t exist.” —— skill-audit 的灵感来自 @HiTw93 的 Waza 项目。

小结

当你的 Skill 树膨胀到数十个，运行一次 skill-audit 大概率会让你发现两件事：一是有一批从来没跑过的 Skill，二是你写的某些强制规则其实从未生效。这两个信息都值得认真对待。

参考资料

• runesleo/claude-skill-audit
• tw93/Waza