stats
Use when user invokes /stats or asks about Claude Code usage, token consumption, session history, model distribution, or activity patterns. Generates an interactive HTML dashboard with charts and tables, auto-opens in browser. Also triggers on "how much have I used Claude", "show my usage", "token usage", "session stats", "usage report", "usage dashboard". Do NOT use for API billing or cost estimation — token counts are not costs.
npx skills add majiayu000/claude-skill-registry --skill stats-harnessprotocol-harness-kit --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Claude Code Usage Dashboard ## Overview Generate an interactive HTML dashboard from Claude Code's local session data. The dashboard shows daily activity, model distribution, project breakdown, hourly patterns, and session details — with live filtering and sortable tables. **Core principles:** 1. **Script-first.** A Python script aggregates all data and produces the HTML. Claude never parses raw JSONL files. 2. **Browser-native.** The output is a self-contained HTML file with Chart.js charts and client-side filtering. No server needed. 3. **Read-only.** The script only reads from `~/.claude/`. It writes one temp HTML file and opens the browser. ## Workflow (MANDATORY) ### Step 1: Parse Arguments Map the user's request to CLI flags: | User says | Flags | |-----------|-------| | `/stats` (no args) | `--range 14d` | | "last week" | `--range week` | | "last month" | `--range month` | | "last 30 days" | `--range 30d` | | "all time" / "everything" | `--range all` | | "March 1 to March 10" | `--start 2026-03-01 --end 2026-03-10` | Convert relative dates to absolute `YYYY-MM-DD` format. If the user gives a vague range, default to `--range 14d`. ### Step 2: Run the Dashboard Generator Exec
- Overview
- Workflow (MANDATORY)
- Step 1: Parse Arguments
- Step 2: Run the Dashboard Generator
- Step 3: Summarize in Conversation
- Step 4: Offer Follow-Up
- Scope Controls
- Common Mistakes
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/generate_dashboard.py" <flags>What does the stats skill do?
Use when user invokes /stats or asks about Claude Code usage, token consumption, session history, model distribution, or activity patterns. Generates an interactive HTML dashboard with charts and tables, auto-opens in browser. Also triggers on "how much have I used Claude", "show my usage", "token usage", "session stats", "usage report", "usage dashboard". Do NOT use for API billing or cost estimation — token counts are not costs.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill stats-harnessprotocol-harness-kit --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.