skill-usage-report

skill-usage-report — Skill ツール経由起動率レポート

skill-analyzer plugin の Skill 利用率分析 skill。 transcript JSONL から Skill tool 経由で起動された skill の名前と回数を期間別に集計する。

重要な前提

Claude Code の transcript JSONL は Skill tool 経由で起動された skill のみ記録する。description マッチによる auto-trigger 経由の起動は記録されない。 結果として:

• "0 起動" = "Skill ツール経由起動 0 回"。auto-trigger で頻繁に使われている可能性大。
• 削除判断には本 skill の出力を 「最小推定」 として扱い、skillOverrides: off で 1 週間 dry-run してから判断推奨。

実行手順

1. 対象期間を決定:

   • 引数なし → 全期間 (~/.claude/projects/**/*.jsonl 全走査)
   • "今週" / "this week" → --since 7日前 --until today
   • "今月" / "this month" → --since 30日前 --until today
   • 任意期間 → --since YYYY-MM-DD --until YYYY-MM-DD

2. 集計実行:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/jsonl-usage.sh" \
     --since 2026-05-01 --until 2026-05-08
   

3. 出力 JSON を整形してユーザーに表示:

   • skill 別 起動回数 (降順 sort)
   • 0 回 (= 削除候補) を別 section
   • 警告 (auto-trigger 不可視) を冒頭に明示

4. 共有用エクスポート:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/jsonl-usage.sh" --since ... --until ... \
     | bash "${CLAUDE_PLUGIN_ROOT}/scripts/lib/sanitize.sh" \
     > usage-report.json
   

出力例 (markdown 整形後)

## Skill usage report (2026-05-01 → 2026-05-08)

> Note: counts reflect Skill-tool invocations only. Auto-trigger usage is NOT recorded.

### 起動された skill

| skill | invocations |
|---|---:|
| observe | 10 |
| evolve | 7 |
| slide-quality-review | 5 |
| codex | 1 |
| subtree | 1 |

### 0 起動 (要確認、削除前に dry-run)

(... auto-trigger で使われているか ANALYZE_TARGET の SKILL.md frontmatter description を確認 ...)

関連 skill

• improvement-proposal: 本 skill の出力 + prompt-redundancy-check 結果を統合した提案生成
• mcp-usage-report: MCP server / tool 利用率の同種分析