Agent skill · data analytics · anthropics
session-report
Generate an explorable HTML report of Claude Code session usage (tokens, cache, subagents, skills, expensive prompts) from ~/.claude/projects transcripts.
Why this skill is useful
Adds a specific workflow for generating detailed HTML reports from Claude Code session data, which includes data analysis and presentation patterns not commonly found in public documentation.
What it needs
Requires node installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 33,212 stars on the source repository.
What this skill does
Session Report Produce a self-contained HTML report of Claude Code usage and save it to the current working directory. Steps 1. Get data. Run the bundled analyzer (default window: last 7 days; honor a different range if the user passed one, e.g. 24h, 30d, or all). The script analyze-sessions.mjs lives in the same directory as this SKILL.md — use its absolute path: For all-time, omit --since. 2. Read /tmp/session-report.json. Skim overall, byproject, bysubagenttype, byskill, cachebreaks, topprompts. 3. Copy the template (also bundled alongside this SKILL.md) to the output path in the current working directory: 4. Edit the output file (use Edit, not Write — preserve the template's JS/CSS): Replace the contents of <script id="report-data" type="application/json"> with the full JSON from step 1. The page's JS renders the hero total, all tables, bars, and drill-downs from this blob automatically. Fill the <!-- AGENT: anomalies --> block with 3–5 one-line findings. Express figures as a % of total tokens wherever possible (total = overall.inputtokens.total + overall.outputtokens). One line per finding, exact markup: Classes: .take bad for waste/anomalies (red), .take good for healthy signals (green), .take info for neutral facts (blue). The .fig is one short number (a %, a count, or a multiplier like 12×). The .txt is one plain-English sentence naming the project/skill/prompt; wrap the subject in <b>. Look for: a project or skill eating a disproportionate share, cache-hit <85%, a single prompt >2% of total, subagent types averaging >1M tokens/call, cache breaks clustering. Fill the <!-- AGENT: optimizations --> block (at the bottom of the page) with 1–4 <div class="callout"> suggestions tied to specific rows (e.g. "/weekly-status spawned 7 subagents for 8.1% of total — scope it to fewer parallel agents"). Do not restructure existing sections. 5. Report the saved file path to the user. Do not open it or render it. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills anthropics/session-report