session-report

Generate explorable HTML reports from Claude Code session transcripts with usage summaries.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/victorjoshi9/content--1- --skill session-report-victorjoshi9
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-report
Source: https://github.com/victorjoshi9/content--1-/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/session-report/skills/session-report
Command: npx skills add https://github.com/victorjoshi9/content--1- --skill session-report-victorjoshi9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns raw Claude Code session transcripts into a clear, explorable HTML report so you can understand where time, tokens, cache misses, and subagent work are going.

Core Features & Use Cases

  • Usage Analysis: Summarizes token consumption, cache behavior, session counts, and activity windows from Claude Code project transcripts.
  • Bottleneck Detection: Highlights expensive prompts, cache breaks, heavy projects, and unusually costly subagent types to surface waste quickly.
  • Interactive Reporting: Produces a self-contained HTML dashboard with sortable tables, timeline views, drill-down context, and narrative findings.
  • Use Case: Review a week of Claude Code work to identify which project or prompt consumed the most tokens and where cache efficiency dropped.

Quick Start

Ask the session-report skill to analyze the desired Claude Code time range and save a self-contained HTML report in the current working directory.

Frequently Asked Questions about session-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an HTML report from Claude Code session transcripts?

To generate an HTML report from Claude Code session transcripts, use the session-report skill to parse JSONL transcript data, deduplicate entries, and embed interactive JSON into a self-contained HTML dashboard summarizing token usage and cache behavior.

How can I analyze Claude Code token usage and cache efficiency?

You can analyze Claude Code token usage and cache efficiency by processing session transcripts to summarize cache misses, token consumption, and subagent activity, which surfaces bottlenecks and unusually costly prompts.

Does the session report tool work with all-time project history or just recent sessions?

The session report tool works with both recent and all-time usage analysis, allowing you to drill down into specific project sessions to detect anomalies and disproportionate spend across your entire Claude Code history.

What is the best way to identify expensive prompts and subagent activity in Claude Code?

The best way to identify expensive prompts and heavy subagent activity is to aggregate session transcript data into an interactive dashboard, highlighting cache breaks and costly subagent types to surface waste quickly.

Can I audit subagent activity and token consumption without external dependencies?

Yes, you can audit subagent activity and token consumption without external dependencies because the skill operates independently by reading bundled HTML templates and embedding full report JSON directly into the output file.

Why does my Claude Code session report show duplicate transcript entries?

Duplicate transcript entries appear in raw JSONL data, but the report generation process applies deduplication logic to preserve accurate token counts and cache efficiency metrics without inflating usage statistics.