| name | frontend-skills-stats |
| description | Analytics dashboard for frontend-skills hook harness. Latency percentiles, top-violated rules, zero-fire hooks, session trends. Use when user ask for hook harness stats, invoke `/frontend-skills-stats`, or want latency profiling and manifest drift checks. |
Frontend skills stats
Step 0: Gather context
Run these Bash commands before proceed:
ls "$(git rev-parse --show-toplevel 2>/dev/null)/.claude/hooks/"*.sh 2>/dev/null | wc -l -- installed hook scripts
jq '[.hooks[]?[]?.hooks[]?] | length' "$(git rev-parse --show-toplevel 2>/dev/null)/skill-manifest.json" -- wired hooks
ls ~/.claude/hook-metrics/*.json 2>/dev/null | wc -l -- session summaries
ls ~/.claude/hook-metrics/*.json 2>/dev/null | head -1 | xargs -I{} jq -r '.date' {} -- earliest date
ls ~/.claude/hook-metrics/*.json 2>/dev/null | tail -1 | xargs -I{} jq -r '.date' {} -- latest date
Metrics dir: ~/.claude/hook-metrics/
Your task
Analyze frontend-skills harness across all session metrics. Read every JSON in ~/.claude/hook-metrics/. Produce prioritized report.
1. Latency profile
Parse perf_ms from each session summary (added 2.2.2). Each hook:
| Hook | P50 (ms) | P95 (ms) | Invocations | Total wall-clock |
|---|
Flag hooks:
- P95 > 100ms -> perf budget breach
- P95 > 500ms -> critical
- Invocations = 0 all sessions -> zero-fire candidate
2. Rule activity
Each rule fired once+:
| Rule | Blocks | Warns | Nudges | Info | Diagnostic |
|---|
Detect new tier usage (nudge, info, diagnostic -- added 2.2.2). Report adoption rate.
3. Silent hooks (zero fires)
List wired hooks, zero fires all sessions. Prune candidates.
4. Over-aggressive hooks
- Blocks-per-session > 3 -> too strict, demote to warn
- Same rule blocked >= 2x one session -> Claude retrying, message unclear
- block-strict, no escape-hatch adoption -> rule too harsh
5. Under-enforced rules
Cross-ref CLAUDE.md rules vs hook activity:
- Rule in CLAUDE.md, no hook -> advisory; add hook or accept doc-only
- Rule has hook, zero fires -> Claude never violates; safe
- Rule has hook, high fire rate -> document in README prominently
6. Session health signals
- Sessions with hook errors (exit > 0 not in {0, 2}) -> config bug
- Sessions with >20 blocks same rule -> feedback loop
- Sessions with 0 hook fires -> perfect compliance or hooks dead
7. Manifest drift check
Compare skill-manifest.json vs .claude/settings.json and hooks/hooks.json:
bash scripts/generate-hook-configs.sh --check
Drift detected: RED FLAG -- drift bug regression. Run --apply to fix.
Output format
Structured report. Tables for numeric data. End with prioritized action list (max 5 items). If <5 session files, mark recommendations preliminary.
Plain markdown. No emojis.