session-report

Generate an interactive HTML report from Claude Code session transcripts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the generation of an interactive HTML report from Claude Code session transcripts, providing insights into usage patterns and highlighting areas for optimization.

Core Features & Use Cases

  • Report Generation: Creates a detailed HTML report summarizing Claude Code session usage, including tokens, cache usage, subagents, and expensive prompts.
  • Data Analysis: Analyzes session transcripts to identify patterns and anomalies in usage, such as cache breaks and subagent activity.
  • Use Case: Imagine you have a team of AI researchers using Claude Code for various projects. This Skill can help you track and analyze the usage of the platform, identifying bottlenecks and areas for improvement.

Quick Start

Generate a report for the last 7 days of Claude Code sessions using 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 generate an interactive report from Claude Code session transcripts?

You can generate an interactive report from Claude Code session transcripts by running a session analysis script that parses token counts, cache usage, and subagent activity. The skill processes historical transcript data to produce a visual HTML report summarizing platform usage patterns.

What insights can I get from Claude Code session usage analysis?

Claude Code session usage analysis provides insights into token counts, cache breaks, subagent activity, and expensive prompts. It identifies usage patterns and anomalies to help highlight areas for optimization within your platform interactions.

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

Yes, you need Node.js installed as a runtime environment to execute the session analysis script. The data collection process relies on a Node.js script to parse transcripts and feed data into the HTML report template.

Can I track subagent activity and cache usage in Claude Code reports?

Yes, you can track subagent activity and cache usage in Claude Code reports. The analysis process specifically extracts cache break events and subagent interactions from session transcripts to identify performance bottlenecks and anomalies within your projects.

What is the best way to identify expensive prompts in Claude Code sessions?

The best way to identify expensive prompts in Claude Code sessions is to generate an automated HTML report. The analysis highlights high-cost interactions by parsing token counts and usage patterns directly from your historical session transcripts.

Are there limitations when automating report generation for Claude Code sessions?

Limitations of automating report generation include dependency on Node.js and the requirement of specific template files for formatting. The analysis is restricted to data available in session transcripts, meaning external platform metrics are not captured.