session-report

Analyze Claude Code session transcripts to generate HTML usage reports.

Updated May 29, 2026
One-click install
npx skills add https://github.com/Hex-4/dots --skill session-report-hex-4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-report
Source: https://github.com/Hex-4/dots/tree/main/dot_claude/plugins/marketplaces/claude-plugins-official/plugins/session-report/skills/session-report
Command: npx skills add https://github.com/Hex-4/dots --skill session-report-hex-4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node, analyze-sessions.mjs, template.html, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a detailed report of Claude Code session usage, allowing users to analyze and monitor their usage of tokens, cache, subagents, skills, and expensive prompts.

Core Features & Use Cases

  • Comprehensive Reporting: Generates an explorable HTML report detailing various aspects of Claude Code session usage.
  • Usage Analysis: Tracks and reports on tokens, cache, subagents, skills, and expensive prompts.
  • Data Visualization: Utilizes an HTML template to display the data in an easily digestible format.
  • Use Case: Ideal for administrators or users who need to track and analyze the usage of Claude Code to ensure efficient and cost-effective use.

Quick Start

Generate a session report for the last 7 days by running the 'session-report' skill.

Frequently Asked Questions about session-report

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

FAQPage Schema
How do I analyze Claude Code session transcripts for token usage?

This Skill analyzes Claude Code session transcripts from JSONL files to extract metrics on tokens, cache, subagents, and skills, generating an explorable HTML report. It uses the 'analyze-sessions.mjs' script for data extraction to provide comprehensive usage analysis.

How do I generate an HTML report of Claude Code session usage?

You can generate an HTML report of Claude Code session usage by running the 'session-report' skill. It utilizes a provided HTML template to visualize extracted transcript data, allowing you to track and monitor tokens, cache, subagents, skills, and expensive prompts in an easily digestible format.

What data formats are required to analyze Claude Code session logs?

Analyzing Claude Code session logs requires JSONL files containing transcript data. The Skill processes these JSONL files using the 'analyze-sessions.mj' script to extract specific usage metrics like tokens and cache, then renders the results into an HTML report via 'template.html'.

Does this session report tool require Node.js to run?

Yes, this session report tool requires Node.js to run because it relies on the 'analyze-sessions.mjs' JavaScript script for data extraction. You need the Node environment to execute the script that parses JSONL transcripts and feeds data into the HTML template.

Can I monitor expensive prompts in Claude Code session transcripts?

Yes, you can monitor expensive prompts in Claude Code session transcripts. The Skill analyzes JSONL transcript data to track and report on usage metrics, specifically including the identification of expensive prompts, alongside tokens, cache, subagents, and skills within the generated HTML report.