Pulls the last week's worth of Claude Code transcripts from your ~/.claude/projects directory, crunches token usage, cache stats, subagent calls, and skill invocations, then drops a self-contained HTML report in your working directory. The template renders sortable tables and bar charts, while the skill injects a handful of one-line findings: which projects or skills are eating disproportionate tokens, where cache hit rates are sagging, whether a single expensive prompt is skewing your totals. It's forensics for your own usage. If you've ever wondered why your cache credits evaporated or which subagent type is burning through context, this gives you percentages and drill-downs instead of hunches.

skills.sh installs
4.3K
GitHub stars
46.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add anthropics/claude-plugins-official --skill session-report --agent claude-code

Installs into .claude/skills of the current project.

Files

Session Report

Produce a self-contained HTML report of Claude Code usage and save it to the current working directory.

Steps

  1. Get data. Run the bundled analyzer (default window: last 7 days; honor a different range if the user passed one, e.g. 24h, 30d, or all). The script analyze-sessions.mjs lives in the same directory as this SKILL.md — use its absolute path:

    node <skill-dir>/analyze-sessions.mjs --json --since 7d > /tmp/session-report.json
    

    For all-time, omit --since.

  2. Read /tmp/session-report.json. Skim overall, by_project, by_subagent_type, by_skill, cache_breaks, top_prompts.

  3. Copy the template (also bundled alongside this SKILL.md) to the output path in the current working directory:

    cp <skill-dir>/template.html ./session-report-$(date +%Y%m%d-%H%M).html
    

Sponsors

Details

Repository
github.com/anthropics/claude-plugins-official
Category
Frontend Development
First seen
Jun 3, 2026

More from anthropics/claude-plugins-official

All 24
1softaworks avatarc4-architecturesoftaworks/agent-toolkitGenerate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize sof4.3Kskills.sh installs
2yaklang avatarandroid-pentesting-tricksyaklang/hack-skillsAndroid pentesting playbook. Use when testing Android applications for SSL pinning bypass, exported component abuse, WebView vulnerabilities, intent redirection4.3Kskills.sh installs
3giuseppe-trisciuoglio avatarturborepo-monorepogiuseppe-trisciuoglio/developer-kitProvides comprehensive Turborepo monorepo management guidance for TypeScript/JavaScript projects. Use when creating Turborepo workspaces, configuring turbo.json4.2Kskills.sh installs
4dpearson2699 avatarwidgetkitdpearson2699/swift-ios-skillsImplement, review, or improve WidgetKit widgets and controls. Use when building Home Screen, Lock Screen, StandBy, or CarPlay widgets with timeline providers; c4.2Kskills.sh installs
5assistant-ui avatarobservabilityassistant-ui/skillsAdds tracing, telemetry, and observability to an assistant-ui backend. Use when wiring an AI SDK route handler (streamText/generateText, toUIMessageStream, crea4.2Kskills.sh installs
6agents365-ai avatarcreating-mermaid-diagramsagents365-ai/365-skillsGenerate Mermaid diagrams (.mmd) and export to PNG/SVG/PDF using mmdc CLI or Kroki API. USE THIS SKILL when user mentions diagram, flowchart, sequence diagram, 4.2Kskills.sh installs