session-report
Generate a comprehensive session report with per-model token usage (input, output, cache_read, cache_write including compaction baselines), cost breakdown via the pricing engine, tool invocations, agent hierarchy, compaction events, API errors, turn durations, and thinking block counts
Install / Use
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill session-reportInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OperationsSupported Platforms
Our assessment of session-report
session-report scores 81/100 on our quality scale, 653rd of 763 Operations skills we index.
Its SKILL.md is 3.6 KB long, well organised into 14 sections and no code examples: a solid amount of guidance for an agent.
With 1,015 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so session-report is actively maintained.
- Our last check on 2026-11-08 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
session-report compared with similar skills
All 4 of these similar skills score higher than session-report; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| session-report (this skill)by hoangsonww | 81 | 1.0k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 104.9k | 5d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.7k | 2d ago | MCP Server |
Frequently asked questions
- How do I install session-report?
- Run
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill session-report. The install tabs above show the steps for each supported agent. - Which AI agents does session-report work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is session-report safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is session-report still maintained?
- The repository was last updated about 2 months ago, so session-report is actively maintained.
Skill content
View source on GitHubname: session-report description: > Generate a comprehensive session report with per-model token usage (input, output, cache_read, cache_write including compaction baselines), cost breakdown via the pricing engine, tool invocations, agent hierarchy, compaction events, API errors, turn durations, and thinking block counts. Use when reviewing a specific session or summarizing activity over a date range.
Session Report
Generate a detailed session report from the Claude Code Agent Monitor.
Input
The user provides: $ARGUMENTS
This may be a session ID, "latest", or a date range like "last 24 hours".
Data Sources
All data comes from the Agent Monitor API at http://localhost:4820:
| Endpoint | What it returns |
|----------|----------------|
| GET /api/sessions/{id} | Session with nested .agents[] and .events[] |
| GET /api/sessions?limit=50 | Session list with agent_count, last_activity, and inline cost per session (bulk pricing applied server-side) |
| GET /api/pricing/cost/{sessionId} | { total_cost, breakdown: [{ model, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cost, matched_rule }] } |
| GET /api/events?session_id={id} | Event stream: each has event_type, tool_name, summary, data (JSON), created_at |
Key data points available per session
- Status:
active/completed/error/abandoned - Model: primary model (e.g.
claude-sonnet-4-20250514) - Metadata (JSON):
thinking_blockscount,turn_count,total_turn_duration_ms,usage_extras(service_tier, speed, inference_geo) - Token usage per model: Pricing breakdown reports
input_tokens,output_tokens,cache_read_tokens,cache_write_tokensper model (baselines are pre-summed into these totals at the DB level) - Cost formula:
(tokens / 1,000,000) × rate_per_mtokfor each of 4 token types, using longest-match pricing rule - Agent hierarchy: recursive parent_agent_id tree, subagent_type (e.g. "task", "explore", "code-review", "compaction")
- Event types:
PreToolUse,PostToolUse,Stop,SubagentStop,SessionStart,SessionEnd,Notification,Compaction,APIError,TurnDuration
Report Sections
1. Session Overview
- ID (first 16 chars), name, status, model, working directory
- Start → end time, total duration
- Turn count and avg turn duration (from metadata)
2. Token Usage (per model)
Include these columns: Model, Input, Output, Cache Read, Cache Write, and Total.
Show effective totals (current + baseline) since baselines preserve tokens lost during compaction. Calculate cache hit rate: cache_read / (cache_read + input) × 100.
3. Cost Breakdown
From /api/pricing/cost/{id} — show each model's cost with the matched pricing rule. Note rates are per million tokens.
4. Agent Hierarchy
Render the agent tree (main → subagents, with nested children). For each agent: name, type, subagent_type, status, task (first 60 chars), duration.
5. Tool Activity
Count PreToolUse events by tool_name. Flag tools that appear in error events. Note subagent spawns (tool_name = "Agent").
6. Compaction & Context Health
- Count of
Compactionevents (each = context was compressed) - Baseline tokens recovered (sum of baseline_* columns)
- Thinking block count from metadata
7. API Errors
List any APIError events with type (quota, rate_limit, overloaded) and message.
8. Timeline
Key lifecycle events: SessionStart → first tool → compactions → errors → Stop → SessionEnd. Include TurnDuration events.
Output Format
Clean Markdown: executive summary line, structured tables, agent tree, numbered timeline. Bold key metrics.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
104.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.7kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
