skills.rest
lucasfth
lucasfthCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

session-report

Aggregate Claude Code session transcripts into an explorable HTML usage report.

1|Updated Apr 30, 2025
Search Tags:#subagents#claude-code#html-report#usage-analysis#token-tracking#session-report
One-click install
npx skills add https://github.com/lucasfth/config --skill session-report-lucasfth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-report
Source: https://github.com/lucasfth/config/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/session-report/skills/session-report
Command: npx skills add https://github.com/lucasfth/config --skill session-report-lucasfth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Session Report Skill aggregates Claude Code transcripts to generate a self-contained, explorable HTML report that reveals tokens, cache activity, subagents, and costly prompts from your Claude sessions.

Core Features & Use Cases

  • Generate a standalone HTML report summarizing session usage, token breakdown, cache behavior, and subagent activity.
  • Analyze transcripts with the bundled analyze-sessions.mjs to produce a ready-to-embed data blob and a clean template for viewing.
  • Use the HTML template.html to render an interactive view that you can save and share for audits or optimization.

Quick Start

Run the bundled analyzer to generate the JSON report and copy the template.html to the output path, then embed the data into the HTML report.

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, run the bundled analyze-sessions.mjs analyzer using Node.js to aggregate the data, then embed the resulting data blob into the template.html to create an explorable report.

What does a Claude Code session usage report include?▼

A Claude Code session usage report includes a detailed breakdown of tokens, cache activity, subagent activity, and costly hotspot prompts, applied across the last 7 days or custom ranges to surface data for debugging and auditing.

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

Yes, you need Node.js to analyze Claude Code session transcripts, because the bundled analyze-sessions.mjs analyzer relies on the Node.js runtime to execute and aggregate the transcript data into a machine-readable format.

Can I analyze Claude Code tokens and subagent activity for a custom date range?▼

Yes, you can analyze Claude Code tokens and subagent activity for a custom date range, as the session analyzer supports applying aggregation across the last 7 days or specified custom ranges to surface targeted usage metrics.

What is the best way to audit Claude Code token usage and hotspot prompts?▼

The best way to audit Claude Code token usage and hotspot prompts is to generate a standalone HTML report using the session analyzer, which provides an interactive view of cache behavior and subagent activity that you can save and share.

Are there limitations when using a bundled HTML template for session reporting?▼

A limitation of using a bundled HTML template for session reporting is that the output is strictly a self-contained static HTML file, meaning interactive filtering or live data updates require modifying the template or data embedding process directly.

Related Skills

Explore More Data & Analytics Skills→
ianphilianphil

share-transcript

Upload Claude Code session transcripts to GitHub Gist and update the gist index.

Community
Intermediate
gkganesh12gkganesh12
1

gk-ledger

Generates an HTML cost report from project JSON history files.

Community
Intermediate
pynbj1001pynbj1001
4

PAI

Define the central reference for Personal AI Infrastructure orchestration.

Community
Advanced
paulnsorensenpaulnsorensen
2

session-analytics

Aggregate Claude Code JSONL session logs into a queryable DuckDB database.

Community
Advanced