skills.rest
paulingham
paulinghamCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/paulingham/.claude --skill cost-report-paulingham
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Data & Analytics Skills→
shepard-systemshepard-system
70

obs-sessions

Retrieve recent AI coding sessions with provider, model, duration, and cost.

Official
Intermediate
ShubhamManachekarShubhamManachekar

financial-analyst

Automate INR-denominated cost tracking, budgeting, and ROI analysis for GeoSupply.

Community
Advanced
jasonmichaelbell78-creatorjasonmichaelbell78-creator

pr-retro

Generate structured retrospectives for PR review cycles with action-item tracking.

Community
Advanced
tygwantygwan
1

analytics

Aggregate and visualize CLI tool usage statistics from telemetry metrics.

Community
Intermediate