claude-skill-tracker · 中文指南

零依赖 CLI 工具，追踪 Claude Code 的 skill 使用频次，帮你发现和清理僵尸 skill，保持 AI 工具链干净高效。

我为什么做这个工具

Claude Code 的 skill 生态很丰富，但也很容易失控——装了 30 个 skill，真正每天用的可能只有 5 个。

每个不用的 skill 都是隐形成本：

• 在系统提示中占据 token 空间
• 让 skill 列表变得臃肿，每次翻找都浪费时间
• 让你分不清哪些是"真正好用"、哪些是"装完就忘了"

claude-skill-tracker 就是干这个的。

核心特点

• 零依赖 — 100% Node.js 内置模块，不装任何第三方包，npm install 秒完
• 安装即用 — init 一下，自动注册 hook，无需手动配置
• 无感追踪 — 后台静默记录，对 Claude Code 性能零影响（hook 脚本执行 ≈ 0.1ms）
• 智能报告 — Unicode 表格 + ANSI 颜色，一眼看出高频 skill 和僵尸 skill
• 多维度过滤 — 按时间范围、按项目筛选，想看哪个维度看哪个
• 数据本地化 — 所有数据存在 ~/.claude/skill-usage.jsonl，不上传、不联网
• 换设备即用 — npm install -g + init，两行命令搞定

安装

npm install -g claude-skill-tracker
claude-skill-tracker init

从此以后，每一次 skill 调用都会被自动记录。

命令一览

| 命令 | 用途 | |---|---| | claude-skill-tracker init | 在 ~/.claude/settings.json 中注册 PostToolUse hook，开始追踪 | | claude-skill-tracker uninit | 移除 hook（日志数据保留） | | claude-skill-tracker stats | 显示完整使用报告 | | claude-skill-tracker stats -d 30 | 只看最近 30 天的报告 | | claude-skill-tracker stats -p my-project | 只看某个项目的报告 |

效果展示

┌──────────────────────────────────────────────────────────────────────┐
│ Skill Usage Report — 2026-05-15 · 21 skills                          │
│ 45 total calls  ● 8 active  ◐ 3 stale  ○ 5 zombie  · 5 unused       │
├──────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  🔥  Used Skills                                                     │
│                                                                      │
│ Rank   Skill               Count   Last Used    Status   Projects    │
│ ─────  ─────────────────── ──────  ──────────   ──────   ──────────  │
│ 1.     neat-freak             12   2026-05-15   active   visio,my-ai │
│ 2.     canvas                  8   2026-05-14   active   visio       │
│ 3.     hv-analysis             5   2026-05-13   active   my-ai       │
│ 4.     khazix-writer           4   2026-05-10   active   my-ai       │
│ 5.     codebase-analysis       2   2026-05-08   active   visio       │
│ 6.     review                  1   2026-04-20   zombie   visio  💀   │
│                                                                      │
│  💤  Never Used (15 skills)                                          │
│                                                                      │
│  · aihot                   · migrate-to-skills                      │
│  · babysit                 · quant-analyst                          │
│  · create-hook             · shell                                  │
│  · create-rule             · split-to-prs                           │
│  · create-subagent         · statusline                             │
│  · cursor-sdk              · update-cli-config                      │
│  · find-skills             · update-cursor-settings                 │
│  · loop                    · ...                                    │
│                                                                      │
│  45 total calls · 21 skills · 6 used · 15 never touched             │
└──────────────────────────────────────────────────────────────────────┘

状态图例

| 图标 | 颜色 | 含义 | |---|---|---| | ● | 绿色 | 活跃 — 14 天内使用过，继续保留 | | ◐ | 黄色 | 沉寂 — 14-30 天未使用，关注一下 | | ○ | 红色 | 僵尸 — 超过 30 天未使用，考虑删除 | | · | 灰色 | 从未使用 — 装了从来没用过，强烈建议删除 |

工作原理

Skill 被调用 → PostToolUse hook 触发 → track-skill.sh 追加一行 JSONL
                                          ↓
                           ~/.claude/skill-usage.jsonl
                                          ↓
                          claude-skill-tracker stats
                                          ↓
                              漂亮的终端报告 📊

1. init 在 ~/.claude/settings.json 中写入一个匹配 Skill 工具的 PostToolUse hook
2. 每次 Claude Code 调用 skill 时，hook 脚本向 ~/.claude/skill-usage.jsonl 追加一行 JSON
3. stats 读取 JSONL，与 ~/.claude/skills/ 中已安装的 skill 交叉比对，生成完整报告

所有数据存在本地，零网络请求、零遥测、零隐私风险。

典型使用场景

• 定期清理：每月跑一次 stats -d 30，删掉标记为 💀 僵尸 和 · 从未使用 的 skill
• 新人入职：分享 skill 配置前先跑一次 stats，只导出经过验证的高频 skill
• 工具链审计：看看哪些 skill 在"装的时候很激动、用的时候完全想不起来"
• 多项目对比：stats -p project-a vs stats -p project-b，了解不同场景的工作流差异

常见问题

Q: 会影响 Claude Code 性能吗？
A: 不会。hook 脚本只是一个 bash 文件追加操作，耗时约 0.1ms，完全无感。

Q: 不跑 init 能用吗？
A: stats 命令本身独立可用，但没有 init 就没有数据来源。

Q: 数据存在哪？
A: ~/.claude/skill-usage.jsonl — 纯文本，一行一个 JSON，随时可查看、可删除。

Q: 会追踪用户的其他信息吗？
A: 只记录 { skill, project, timestamp } 三个字段。不包含 prompt 内容、不包含文件路径、不包含任何个人信息。

Q: 想清空统计数据重新开始？
A: 删除或清空 ~/.claude/skill-usage.jsonl 即可。

相关链接

• Claude Code 官网
• Claude Code Hooks 文档
• GitHub 仓库

协议

MIT © kevinwang04