sprint-summary — Claude Code skill: what it does, how to install
Summarizes Claude Code sprint activity using Agent Monitor data: session costs, model breakdown, project groupings, and velocity metrics.
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a claude-codeWhat sprint-summary does
This skill compiles sprint reports from Claude Code Agent Monitor data. It accepts a date range, a period like "last 10 days", or defaults to the last 14 days. It queries http://localhost:4820 directly using the /api/sessions, /api/analytics, and /api/pricing/cost endpoints.
The report groups deliverables by working directory, itemizes dollar costs per model, and calculates velocity trends against the previous sprint. It also tracks token efficiency, covering cache hit rates, context compaction baselines, and tool frequency across the top 15 tools.
If Claude Code Agent Monitor is not running on port 4820, the skill will fail immediately because it relies entirely on that local API.
What it helps with
- track total Claude Code spending across models for a sprint
- group coding sessions and hours by project working directory
- measure token cache hit rates and context compaction frequency
- generate data-driven retrospective action items for team leads
Example prompts for the agent
- Generate a summary for the current sprint
- Summarize Claude Code activity for the last 10 days
- Create a sprint report from 2025-03-31 to 2025-04-13
How to install sprint-summary
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a claude-code2Manually: put the files in place
~/.claude/skills/sprint-summary/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sprint-summary/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a codex2Manually: put the files in place
.agents/skills/sprint-summary/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a cursor2Manually: put the files in place
.cursor/skills/sprint-summary/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor sprint-summary2Manually: put the files in place
.github/skills/sprint-summary/SKILL.md1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path plugins/ccam-productivity/skills/sprint-summaryManually: put the files in place
.devin/skills/sprint-summary/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sprint-summary
How to install sprint-summary in Claude Code?
Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill sprint-summary -a claude-code.
What does sprint-summary do?
It aggregates session history from Agent Monitor into a structured report covering development hours, tool frequency, model expenses, and completion rates.
What prerequisites are required?
You need Claude Code Agent Monitor running locally at http://localhost:4820. The skill pulls all session and analytics data from this endpoint.
Source text
SKILL.md · MIT
---
name: sprint-summary
description: >
Summarize a sprint's worth of Claude Code activity — sessions grouped by
project (cwd), per-model cost breakdown, token efficiency (cache hit rate,
compaction baselines), subagent effectiveness from workflow API, velocity
metrics (turn_count, turn_duration_ms), and tool diversity across the sprint.
---
# Sprint Summary
Generate a sprint summary from Claude Code Agent Monitor data.
## Input
The user provides: **$ARGUMENTS**
This may be:
- A sprint duration: "last 2 weeks", "last 10 days"
- A date range: "2025-03-31 to 2025-04-13"
- "current sprint" (default: last 14 days)
## Procedure
1. **Fetch sprint data** from `http://localhost:4820`:
- `GET /api/sessions?limit=500` — all sessions in range (default sort: most recently updated first)
- `GET /api/analytics` — aggregated metrics
- `GET /api/pricing/cost` — total costs
- For high-value sessions: `GET /api/events?session_id={id}` — event details
2. **Compile sprint summary**:
### 🎯 Sprint Overview
- Sprint period: [start] to [end]
- Total sessions: N (completed: N, errored: N, abandoned: N)
- Total development hours with Claude Code: N
- Total cost: $X.XX
- Overall completion rate: N%
### 📦 Deliverables
Group sessions by working directory (project):
- **Project A** (`/path/to/project`)
- N sessions, N hours, key activities
- **Project B** (`/path/to/other`)
- N sessions, N hours, key activities
### 📊 Velocity Metrics
| Metric | Sprint | Previous Sprint | Trend |
|--------|--------|-----------------|-------|
| Sessions/day | N | N | ↑/↓ |
| Avg session duration | Nm | Nm | ↑/↓ |
| Cost/session | $N | $N | ↑/↓ |
| Tokens/session | N | N | ↑/↓ |
| Completion rate | N% | N% | ↑/↓ |
### 🛠 Technology Breakdown
- Models used with distribution percentages
- Top 15 tools by usage with category grouping
- Subagent utilization rate
### ⚡ Efficiency Analysis
- Token efficiency: cache hit rate, compaction frequency
- Cost per completed task
- Time-to-first-output (avg across sessions)
- Error recovery rate (sessions that recovered from errors)
### 🔄 Retrospective Data Points
- **What went well**: Highest-efficiency sessions, best completion rates
- **What could improve**: Most expensive sessions, highest error rates
- **Action items**: Data-driven suggestions for next sprint
## Output Format
Professional sprint report suitable for sharing with team leads or managers:
- Executive summary paragraph (5 sentences max)
- Structured data tables with trend indicators
- Grouped deliverables by project
- Numbered action items at the end
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor