session-report

Generate HTML reports from Claude Code session transcripts with usage metrics.

Updated Sep 30, 2024
One-click install
npx skills add https://github.com/phillip-hirsch/dotfiles --skill session-report-phillip-hirsch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-report
Source: https://github.com/phillip-hirsch/dotfiles/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/session-report/skills/session-report
Command: npx skills add https://github.com/phillip-hirsch/dotfiles --skill session-report-phillip-hirsch

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill generates an explorable HTML report of Claude Code session usage, including tokens, cache, subagents, skills, and expensive prompts, which helps analyze usage patterns and identify areas for optimization.

Core Features & Use Cases

  • Session Analysis: Provides a detailed report of Claude Code session usage from transcripts.
  • Data Visualization: Offers visual insights into session data, such as token usage and subagent activity.
  • Use Case: Use this Skill to understand which projects or skills are consuming the most resources and identify potential bottlenecks in your workflows.

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 insights?

You can analyze Claude Code sessions by running the session-report skill, which processes transcripts via the analyze-sessions.mjs script to generate an HTML report with token usage, cache metrics, and subagent activity insights.

Can I visualize code usage patterns and expensive prompts from session transcripts?

You can visualize code usage patterns by generating an explorable HTML report that highlights expensive prompts, subagent activity, and skill consumption to help identify workflow bottlenecks and optimization areas.

Do I need Node.js to generate HTML reports from Claude Code sessions?

Node.js is required as a dependency to execute the analyze-sessions.mjs script, which parses Claude Code session transcripts and outputs both structured JSON data and an explorable HTML visualization report.

What is the best way to identify resource bottlenecks in Claude Code workflows?

The best way to identify resource bottlenecks is to generate a session analysis report, which provides visual insights into which projects or skills consume the most tokens and highlights expensive prompts within your workflows.

How do I export structured JSON data from Claude Code session analysis?

You can export structured JSON data by running the analyze-sessions.mjs script on your session transcripts, which processes the raw data and outputs a structured JSON report for further analysis and integration.