usage-report

Measures and reports token usage, elapsed time, and cost for plugin skill runs.

Updated May 26, 2026
One-click install
npx skills add https://github.com/cagriy/dev-skills --skill usage-report-cagriy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usage-report
Source: https://github.com/cagriy/dev-skills/tree/main/skills/usage-report
Command: npx skills add https://github.com/cagriy/dev-skills --skill usage-report-cagriy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running multi-step AI development workflows, there is no visibility into what each run actually cost in tokens, time, and requests. This Skill opens and closes a measurement window around a run and reports the full usage breakdown without ever blocking the work itself. ## Core Features & Use Cases - Run window measurement: A start marker records when a run began, and report measures the window from that marker to the present moment. - Detailed usage table: Emits a markdown table with elapsed time, run time, token totals split across main agent and subagents, request counts, and output throughput. - Durable logging and tracker integration: Appends one line to a persistent usage log and writes the figures into the feature tracker's stage panel via anchored HTML tokens. - Failure-safe design: Every problem degrades to a single usage report skipped line, so reporting never fails, blocks, or aborts the calling skill. - Use Case: A feature-implementation run finishes and the user sees exactly how many tokens the main agent and its eval subagents consumed, how long it took, and the throughput, all logged for later comparison across features. ## Quick Start This Skill is invoked internally by other plugin skills with an argument like report feature-implement, tracker_file=<path>, outcome=completed and is not called directly by users.

Frequently Asked Questions about usage-report

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

FAQPage Schema
How do I measure token usage for a Claude Code skill run?

Invoke the usage-report skill with `start <slug>` at the beginning of a run and `report <slug>` at the end. The report mode measures the window between the two markers and prints a markdown table with token totals, request counts, and throughput.

How to track AI agent costs across multiple sessions?

Each report run appends one line to a durable usage log keyed by session id and skill slug, so parallel sessions never collide. The log accumulates per-run figures that can be compared across features over time.

Can I invoke the usage-report skill directly as a user?

No, the skill is marked user-invocable: false and is only called internally by the four feature-chain skills. It takes its pathing as input from the caller and never asks the user for anything.

What happens if the usage measurement fails or the start marker is missing?

The skill prints a single `usage report skipped` line naming the cause and continues the caller's workflow. It never guesses a start time, never retries, and never blocks or aborts the calling skill.

Does usage reporting include subagent token consumption?

Yes, the underlying script scans the session transcript and splits the token breakdown into main agent, subagents, and total. Subagents never call the skill themselves; their work inside the window is counted by the scan.