session-report

Extract costs, token usage, and bottlenecks from Claude Code session JSON.

4|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/uta2000/feature-flow --skill session-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-report
Source: https://github.com/uta2000/feature-flow/tree/main/skills/session-report
Command: npx skills add https://github.com/uta2000/feature-flow --skill session-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Transforms raw Claude Code session telemetry into an actionable performance report, surfacing costs, token usage, and efficiency signals to inform improvement and debugging.

Core Features & Use Cases

  • Analyze costs and token usage across parent and subagents, with model-level breakdown.
  • Identify top bottlenecks, idle time, and performance opportunities from session telemetry.
  • Generate a structured report suitable for sharing with teams or attaching to a PR.

Quick Start

Run the session-report analyzer on a session JSON file to generate a comprehensive performance report.

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 telemetry data?

To analyze Claude Code session telemetry, you can process the session JSON file to extract core metrics like costs, token usage, and activity patterns, which are then contextualized into a structured performance report.

What is the best way to generate a cost analysis report for Claude Code token usage?

Generating a cost analysis report for token usage involves extracting cost data and model-level breakdowns from the raw session telemetry JSON, identifying top bottlenecks, and highlighting potential optimizations.

Can I identify performance bottlenecks and idle time from a Claude Code session JSON?

Yes, you can identify performance bottlenecks and idle time by extracting activity patterns from the session JSON telemetry to surface inefficiencies and highlight performance improvement opportunities.

How do I get a model-level breakdown of costs across parent and subagents?

To get a model-level breakdown of costs across parent and subagents, you analyze the raw session JSON telemetry to accurately trace token usage and cost metrics without guessing beyond the supported data.

Does the session telemetry report require any external dependencies to process?

No external dependencies are required to process the session telemetry report, as the analyzer directly extracts metrics from the Claude Code session JSON data using self-contained scripts and references.