OBSERVABILITY / Anthropic
Session Report
Runs a bundled Node analyzer over local Claude Code transcripts and fills an HTML template with token use by project, subagent type and skill, cache breaks and the most expensive prompts, plus a few findings and suggestions.
“Generate an explorable HTML report of Claude Code session usage (tokens, cache, subagents, skills, expensive prompts) from ~/.claude/projects transcripts.”
01 / THE REASONING
Why this made the selection.
- Its numbers come from a bundled script, analyze-sessions.mjs, which breaks token use down by project, subagent type and skill and lists cache breaks and the top prompts; the model pastes that JSON into the template and adds 3-5 findings, expressed as shares of total tokens, and 1-4 suggestions.
- The analyzer's header documents how it avoids double counting: assistant entries are deduplicated by requestId, and replayed history in resumed sessions by entry uuid.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/session-report/skills/session-report/SKILL.md
- plugins/session-report/skills/session-report/analyze-sessions.mjs (header, imports, JSON output, prompt previews)
- plugins/session-report/skills/session-report/template.html (head)
- plugins/session-report/LICENSE
- .claude-plugin/marketplace.json (session-report entry)
- README.md
Our findings
- session-report declares no allowed-tools: its frontmatter is a name and a one-sentence description.
- analyze-sessions.mjs imports only fs, os, path and readline; it reads ~/.claude/projects by default, or the directory given with --dir.
- The SKILL.md tells the agent to edit the copied template with Edit, not Write, so the template's JS and CSS are kept, and not to open or render the report.
- If the JSON exceeds 2MB, the SKILL.md says to trim top_prompts and cache_breaks to 100 entries before embedding.
Not established by this review
- The analyzer was not run and no report was produced or opened.
- analyze-sessions.mjs was read for its header, imports and output functions, not line by line; the body of template.html was not read.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- No file in the repository prints an install line for session-report; the plugin directory has no README.
- The repository README gives the general form `/plugin install {plugin-name}@claude-plugins-official`, and the marketplace file lists this plugin under the name session-report; no filled-in line is printed, so install.command is null.
- This review installed nothing and analysed no transcripts.
Before you start
- Local Claude Code transcripts in ~/.claude/projects
- Node, to run node <skill-dir>/analyze-sessions.mjs
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- session-report SKILL.md ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/session-report/skills/session-report/SKILL.md
Supports: upstreamDescription, summary, whySelected[0], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[4], review.findings[0], review.findings[2], review.findings[3], access.permissions[0], access.permissions[2], access.permissions[3], access.cost, install.prerequisites[1], compatibility
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/session-report/skills/session-report/analyze-sessions.mjs
Supports: whySelected[0], whySelected[1], limitations[2], review.findings[1], access.permissions[1], access.permissions[3], install.prerequisites[0]
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/session-report/skills/session-report/template.html
Supports: limitations[1], access.permissions[4]
- session-report LICENSE ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/session-report/LICENSE
Supports: license, access.cost
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json
Supports: install.steps[1], summary
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md
Supports: install.sourceUrl, install.steps[1], compatibility