session-report

Analyze Claude Code session transcripts and generate HTML usage reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node.js, and includes scripts (resource) components.

What problem does it solve?

This Skill provides an automated way to generate detailed usage reports of Claude Code sessions, offering insights into tokens, cache usage, subagents, and skills invoked.

Core Features & Use Cases

  • Generate HTML Reports: Produces explorable HTML reports with insights into Claude Code session usage.
  • Analyze Usage: Identifies and summarizes tokens, cache usage, subagents, and skills used during sessions.
  • Use Case: Imagine you need to understand the resource usage of a specific Claude Code session to optimize it. Use this Skill to generate a report and gain insights into which skills and subagents were used and how much resource they consumed.

Quick Start

Generate a report for the last 7 days of Claude Code sessions with the following command: session-report analyze-sessions.mjs --json --since 7d > /tmp/session-report.json

Frequently Asked Questions about session-report

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

FAQPage Schema
How do I generate a usage report for Claude Code sessions?

You can generate a Claude Code session usage report by running the analyze-sessions.mjs script via Node.js, which outputs an explorable HTML report detailing token usage, cache breaks, and subagent activity.

What does a Claude Code session analysis include?

A Claude Code session analysis includes a detailed breakdown of token usage, cache breaks, and the specific subagents and skills invoked, helping you monitor performance and identify resource optimization areas.

Do I need Node.js to analyze Claude Code session transcripts?

Yes, you need Node.js installed to analyze Claude Code session transcripts, as the Skill relies on JavaScript scripts to process the transcript data and generate the resource monitoring report.

How can I monitor token usage and cache breaks in Claude Code?

You can monitor token usage and cache breaks in Claude Code by running the session-report script, which analyzes your session transcripts and summarizes resource consumption into a comprehensive report.

Can I analyze Claude Code sessions from the last 7 days?

Yes, you can analyze Claude Code sessions from the last 7 days by passing the --since 7d argument to the analyze-sessions.mjs script to filter and generate the report for that specific timeframe.

What is the best way to optimize Claude Code session performance?

The best way to optimize Claude Code session performance is to generate a detailed session usage report to identify which subagents and skills consume the most tokens and adjust your workflow accordingly.