Analisador de Uso de Skills no Claude Code
yang1996202-cpu/skill-stats
Relatórios de frequência de uso de skills com distinção de tipo de acionamento
Ver no GitHubSkill que coleta e exibe estatísticas de uso de skills no Claude Code, diferenciando acionamentos manuais, automáticos por IA/regras e chamadas aninhadas. Integra-se com OpenTelemetry para monitoramento em tempo real sem hacks internos.
Instalação
npx convez-ai yang1996202-cpu/skill-stats1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Medir frequência de uso de skills no fluxo de trabalho
- Identificar padrões de acionamento automático vs manual
- Monitorar telemetria local sem enviar dados para servidor
- Otimizar skill discovery baseado em padrões de uso
Veredito

Ferramenta focada e bem executada para quem precisa entender padrões de uso de skills no Claude Code. Usa OpenTelemetry officialsem dependências frágeis, mas tem curva de aprendizado para configuração de telemetria global.
README
A tradução para o português deste README ainda está na fila.
skillusage
统计 Claude Code skill 使用频率,区分手动触发、AI/规则自动触发、嵌套调用。
特点
- 一个 skill 搞定:安装后输入
/skillusage直接出报表。 - 自动启动接收器:不需要手动开 Python 脚本。
- 可选默认全局开启:一次配置后,所有新 Claude Code 窗口自动带 telemetry。
- 一键打开 telemetry 窗口:
/skillusage launch自动开一个带 telemetry 的新 Claude Code 窗口。 - 官方数据源:基于 Claude Code 的 OpenTelemetry 导出,不是 hack 内部文件。
安装
方式一:一键安装
git clone https://github.com/yang1996202-cpu/skillusage.git ~/projects/skillusage
cd ~/projects/skillusage
./install.sh
install.sh 会:
- 把项目软链到
~/.claude/skills/skillusage(这样 Claude Code 才会注册/skillusage命令)。 - 把
skillusageCLI 软链到~/bin/skillusage。 - 保留
skill-statsCLI 软链到~/bin/skill-stats(供 hooks 使用)。
方式二:手动安装
git clone https://github.com/yang1996202-cpu/skillusage.git ~/projects/skillusage
ln -s ~/projects/skillusage ~/.claude/skills/skillusage
ln -s ~/projects/skillusage/skillusage ~/bin/skillusage
安装完成后,新开一个 Claude Code 窗口,输入 /skillusage 即可。
用法
| 命令 | 作用 |
|---|---|
/skillusage | 查看 skill 使用汇总报表 |
/skillusage web-access | 查看单个 skill 详情 |
/skillusage launch | 打开一个新的 telemetry 窗口 |
默认全局开启 telemetry(推荐)
如果你希望每个新 Claude Code 窗口都自动记录 skill 触发事件,运行:
bash ~/.claude/skills/skillusage/scripts/enable-default-telemetry.sh
这会在 ~/.zshrc 里加一个 claude() 函数包装,自动:
- 设置 telemetry 环境变量。
- 启动 OTLP 接收器。
- 调用真正的
claude。
之后你正常敲 claude 启动的所有窗口都会自动被记录。
想关掉:
bash ~/.claude/skills/skillusage/scripts/disable-default-telemetry.sh
触发方式说明
官方 claude_code.skill_activated 事件里的 invocation_trigger 只有三类:
| 报表列 | telemetry 字段 | 含义 |
|---|---|---|
| 手动触发 | user-slash | 用户手动输入 /xxx 或 /skill xxx |
| AI/规则自动 | claude-proactive | Claude 主动加载,包括语义匹配 + 文件/目录规则触发 |
| 嵌套调用 | nested-skill | 一个 skill 内部调用了另一个 skill |
注意:claude-proactive 把“语义自动触发”和“规则触发”合并在一起了。官方 telemetry 目前没有进一步拆分。
数据是怎么收集的
/skillusage会自动检查本地 OTLP 接收器(scripts/otel-receiver.py),没有就后台启动。- 如果当前窗口不是 telemetry 模式,
/skillusage会在报表顶部提示[telemetry status: DISABLED]。 - 在 telemetry 窗口里正常使用 skill,事件会实时写到
~/.claude/logs/skill-otel.jsonl。 - 回到任意窗口运行
/skillusage,即可看到分类统计。
项目结构
skillusage/
├── SKILL.md # Claude Code skill 定义
├── README.md # 本文件
├── LICENSE # MIT
├── install.sh # 一键安装脚本
├── skillusage # skill 入口 / CLI
├── skill-stats # legacy 数据源汇总 CLI
└── scripts/
├── skillusage.sh # /skillusage skill 主逻辑
├── otel-receiver.py # 本地 OTLP HTTP 接收器
├── skill-otel-report.py # telemetry 报表
├── skill-stats # legacy 数据源汇总 CLI
├── run-claude-with-telemetry.sh # 启动带 telemetry 的 Claude Code
├── enable-default-telemetry.sh # 让 `claude` 默认带 telemetry
└── disable-default-telemetry.sh # 取消默认 telemetry
隐私说明
- 数据只发到本机
127.0.0.1:4318(你自己的接收器)。 - 存储在
~/.claude/logs/skill-otel.jsonl,不会自动传回 Anthropic。 - 默认开启
OTEL_LOG_USER_PROMPTS=1,你的 prompt 会落盘。如果你不想记录 prompt,可以修改run-claude-with-telemetry.sh或enable-default-telemetry.sh,去掉OTEL_LOG_USER_PROMPTS=1。
为什么不用 transcripts
旧版 Claude Code 会在 ~/.claude/transcripts/*.jsonl 里记录 tool_name:"skill" 的调用,但新版本 skill 走 slash command 机制,transcript 里不再出现。官方推荐通过 OpenTelemetry 观察 skill 活动,详见 Claude Code Monitoring 文档。
License
MIT