session-report
Generate an explorable HTML report of Claude Code session usage (tokens, cache, subagents, skills, expensive prompts) from ~/.claude/projects transcripts.
Best for Development teams tracking…Works with GitHubLow risk
⌘source
- author
@anthropics- language
- Python
★18kstars
2.1kforks
Apr 22, 2026
✦overview.md
Key Features
- ·Generates HTML reports from Claude Code session transcripts
- ·Analyzes token usage, cache performance, subagents, and skills
- ·Provides project-level and time-based breakdowns
- ·Includes top prompts and anomaly detection
- ·Self-contained HTML output with interactive visualizations
Use Cases
- →Reviewing Claude Code usage patterns across projects to optimize token consumption
- →Identifying expensive prompts or cache inefficiencies during development sessions
- →Generating usage reports for team retrospectives or cost analysis
- →Monitoring subagent and skill adoption within a development workflow
Best for
- ✓Development teams tracking AI usage
- ✓Cost-conscious engineering managers
- ✓Claude Code power users
Not ideal for
- !Real-time monitoring
- !One-off quick checks
FAQs
name
session-report
description
Generate an explorable HTML report of Claude Code session usage (tokens, cache, subagents, skills, expensive prompts) from ~/.claude/projects transcripts.
Session Report
Produce a self-contained HTML report of Claude Code usage and save it to the current working directory.
Steps
-
Get data. Run the bundled analyzer (default window: last 7 days; honor a different range if the user passed one, e.g.
24h,30d, orall). The scriptanalyze-sessions.mjslives in the same directory as this SKILL.md — use its absolute path:node <skill-dir>/analyze-sessions.mjs --json --since 7d > /tmp/session-report.jsonFor all-time, omit
--since. -
Read
/tmp/session-report.json. Skimoverall,by_project,by_subagent_type,by_skill,cache_breaks,top_prompts. -
Copy the template (also bundled alongside this SKILL.md) to the output path in the current working directory:
cp <skill-dir>/template.html ./session-report-$(date +%Y%m%d-%H%M).html -
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.
- Replace the contents of
$install
1-click copynpx skills add anthropics/claude-plugins-official --skill session-reportSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.