convez.ai
SkillDados & AnalyticsIntermediário
yang1996202-cpu

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-stats

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 会:

  1. 把项目软链到 ~/.claude/skills/skillusage(这样 Claude Code 才会注册 /skillusage 命令)。
  2. 把 skillusage CLI 软链到 ~/bin/skillusage。
  3. 保留 skill-stats CLI 软链到 ~/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-proactiveClaude 主动加载,包括语义匹配 + 文件/目录规则触发
嵌套调用nested-skill一个 skill 内部调用了另一个 skill

注意:claude-proactive 把“语义自动触发”和“规则触发”合并在一起了。官方 telemetry 目前没有进一步拆分。

数据是怎么收集的

  1. /skillusage 会自动检查本地 OTLP 接收器(scripts/otel-receiver.py),没有就后台启动。
  2. 如果当前窗口不是 telemetry 模式,/skillusage 会在报表顶部提示 [telemetry status: DISABLED]。
  3. 在 telemetry 窗口里正常使用 skill,事件会实时写到 ~/.claude/logs/skill-otel.jsonl。
  4. 回到任意窗口运行 /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

Ver o original no GitHub

Bom para

Relacionados