token-report

Generate token usage and cost reports for Claude Code projects and sessions.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/guidodinello/claude-dotfiles --skill token-report-guidodinello
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: token-report
Source: https://github.com/guidodinello/claude-dotfiles/tree/main/.claude/skills/token-report
Command: npx skills add https://github.com/guidodinello/claude-dotfiles --skill token-report-guidodinello

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a concise token usage and cost report for Claude Code usage, helping you monitor and optimize AI spend.

Core Features & Use Cases

  • Token breakdown: Shows per-model token consumption across projects and sessions.
  • Cost estimates: Provides estimated costs based on token usage.
  • Usage insights: Highlights top projects and session patterns for cost awareness.
  • Delegated analysis: Offloads heavy analysis to the stats-analyzer subagent to keep main context clean.
  • Use Case: Quickly audit a sprint's Claude Code usage to identify cost hotspots and optimization opportunities.

Quick Start

Ask it to generate a token usage report for your Claude Code projects and sessions.

Frequently Asked Questions about token-report

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

FAQPage Schema
How do I generate a token usage report for Claude Code projects and sessions?

To generate a token usage report, simply ask the Skill to analyze your Claude Code usage. It delegates analysis to the stats-analyzer subagent and outputs per-model token consumption, cost estimates, and usage patterns verbatim.

Can I audit my Claude Code token consumption and estimated costs across multiple projects?

Yes, you can audit token consumption and estimated costs across multiple projects. The Skill highlights top projects and session patterns to help you identify cost hotspots and optimize your AI spend.

What is the best way to monitor AI spend and identify cost hotspots in Claude Code?

The best way to monitor AI spend is to request a token usage report. It provides a concise breakdown of per-model token consumption and cost estimates, highlighting usage patterns to pinpoint optimization opportunities.

How does the stats-analyzer subagent work when generating token usage reports?

The stats-analyzer subagent handles the heavy analysis to keep the main context clean. The Skill offloads the token consumption and cost data processing to this subagent and presents its output verbatim without local interpretation.

Do I need any dependencies installed to get a per-model token breakdown for my sessions?

No dependencies are required to get a per-model token breakdown. The Skill operates independently to audit your Claude Code sessions and deliver cost estimates and usage insights directly.

token-report: Can it show per-model token consumption like Haiku usage across sessions?

Yes, token-report shows per-model token consumption, including Haiku usage, across projects and sessions. It provides a concise breakdown of token consumption and estimated costs for cost awareness.