delivery-stats

Generates delivery cost and token usage reports for completed epics and tickets.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/PVMalove/claude-agent-harness --skill delivery-stats-pvmalove
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: delivery-stats
Source: https://github.com/PVMalove/claude-agent-harness/tree/main/skills/first-party/pvmalove/delivery-stats
Command: npx skills add https://github.com/PVMalove/claude-agent-harness --skill delivery-stats-pvmalove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After finishing an epic, teams rarely know what the delivery actually cost in tokens, cache usage, money, and code volume. This Skill collects those statistics from local session transcripts, git history, and the issue tracker, then produces an HTML dashboard and a session summary without sending data anywhere. ## Core Features & Use Cases - Epic-level cost reporting: Aggregates tokens by model, cache efficiency, estimated cost, subscription window, and code volume for an epic and all its child tickets. - Baseline comparison: Saves a versioned baseline from a completed epic and compares it against the next one, preserving exact versus estimated attribution per provider. - Honest attribution caveats: Distinguishes exactly-attributed Claude Code work from approximately-attributed Codex work, and reports missing data as "no data" instead of zero. - Use Case: After closing epic #42, run the tool to produce docs/reports/epic-42.html showing per-model token spend, cache split, and cost priced from your own rates.json, then compare it against the baseline saved from epic #38. ## Quick Start Ask the agent to run the delivery stats report for your finished epic, for example: generate the delivery statistics dashboard for epic 42 and save it under docs/reports.

Frequently Asked Questions about delivery-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I measure token usage and cost for a completed epic?▼

Run the delivery_stats.py tool with the epic number to aggregate tokens by model, cache split, and code volume from session transcripts and git history. Cost appears only when a rates.json file prices the models that were used.

How to compare delivery costs between two epics?▼

Save a baseline with --save-baseline after a completed comparable epic, then pass it via --baseline when reporting the next epic. The comparison appears in the terminal, JSON output, and HTML dashboard with per-provider attribution preserved.

Why does the report show no cost numbers?▼

Cost requires a rates.json file that prices the models actually used; there is no built-in price list because prices depend on your plan. Copy rates.example.json, fill in your own rates, and rerun the report.

Is Codex token attribution exact in delivery reports?▼

No, Codex attribution is approximate because its logs carry no branch, only a working directory and timestamp. Totals cover the repository inside the epic's activity window and may include unrelated work, so quote it as an estimate.

What are the limitations of epic delivery statistics?▼

The tool is read-only and cannot invent missing data; unsourced values read as no data rather than zero. ADR counts can be undercounted for squash-merged pull requests, and the tool must already be installed by the harness capability.