cost-report

Aggregate per-session tool timings into a project-wide Markdown spend report.

1|Updated Mar 15, 2026

Search Tags:#pricing #metrics #reporting #pipeline #cost #harness

Ready to run

npx skills add https://github.com/paulingham/.claude --skill cost-report-paulingham

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cost-report
Source: https://github.com/paulingham/.claude/tree/main/skills/cost-report
Command: npx skills add https://github.com/paulingham/.claude --skill cost-report-paulingham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aggregates per-session tool timings and costs into a project-wide spend report to provide cost visibility for harness usage, enabling budgeting insights and performance review with advisory-only guidance.

Core Features & Use Cases

Aggregate per-session tool timings into a project-wide spend report.
Compute per-pipeline costs and cost-per-PR by matching pipeline task IDs with merged PRs (when available) and attach optional PR metadata.
Generate a comprehensive Markdown report with sections for Total Spend, Cost-per-PR by project, Top 3 Pipelines, Top 3 Agents, Preambles Tokens, and Notes; includes sandbox-verify health metrics and dropped-record counts.

Quick Start

Generate a markdown cost report from the latest session data using the tool-timings and costs files in the metrics directory.

Frequently Asked Questions about cost-report

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

FAQPage Schema

How do I generate a project-wide spend report for harness usage costs?▼

You can compute cost-per-PR by matching pipeline task IDs with merged PRs, attaching optional metadata to generate a spend breakdown report that grounds harness usage in currency.

What metrics are included in a harness session cost breakdown?▼

The report scans tool-timings.jsonl and costs.jsonl files to compute total spend, cost-per-PR by project, top 3 pipelines, top 3 agents, and preamble tokens, plus sandbox-verify health metrics.

Do I need specific input files to aggregate per-session tool timings into cost reports?▼

Yes, the cost estimator requires tool-timings.jsonl and costs.jsonl files located in the metrics directory to aggregate per-session timings and write the spend report.

Where are the generated cost summary reports saved?▼

The Markdown spend report is written to ~/.claude/metrics/reports/{YYYY-MM-DD}-cost.md, providing dated cost breakdowns for budgeting insights and model-effectiveness comparisons.

Can I compare model effectiveness using pipeline cost metrics?▼

Yes, the spend report supports model-effectiveness comparisons by aggregating per-session tool timings into per-pipeline costs and top agent role spend metrics for review.