skills.rest
cowwoc
cowwocCOMMUNITY
Explore all skills by this author →
GitHub

cat:token-report

Generate a deterministic token usage report for AI subagents.

101|2|Updated Jan 7, 2026
Search Tags:#reporting#health check#subagent#token usage#context utilization#token-report
One-click install
npx skills add https://github.com/cowwoc/cat --skill cat-token-report
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cat:token-report
Source: https://github.com/cowwoc/cat/tree/main/plugin/skills/token-report
Command: npx skills add https://github.com/cowwoc/cat --skill cat-token-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Display a compact, reliable token usage report across subagents to help engineers understand session resource consumption at a glance and optimize workflow.

Core Features & Use Cases

  • Per-subagent token breakdown with health status and duration to pinpoint inefficiencies.
  • Threshold-based analysis and actionable recommendations for context management.
  • Quick health checks during active sessions and post-task retrospectives to guide decomposition decisions.
  • Use Case: Monitor long-running orchestrations to identify high-cost subagents and reallocate work.

Quick Start

Run the token-report command to view the current session's token usage report. If a pre-computed report is available, results will be displayed exactly as provided; otherwise a deterministic table will be generated for immediate analysis.

Frequently Asked Questions about cat:token-report

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

FAQPage Schema
How do I monitor subagent token usage during an active AI session?▼

To monitor subagent token usage, run a token-report command to display a deterministic table showing per-subagent tokens, context usage, health status, and duration for the current session.

What is the best way to check context utilization for AI subagents?▼

Checking context utilization for AI subagents involves generating a detailed token usage report that provides threshold-based analysis and actionable recommendations for context management.

How do I track per-subagent token breakdowns for post-task retrospectives?▼

Tracking per-subagent token breakdowns for retrospectives requires generating a token usage report that highlights resource consumption, health status, and duration to pinpoint inefficiencies.

Can I use a pre-computed token usage report instead of generating a new one?▼

You can use a pre-computed token usage report by providing it to the system; if available, the results will be displayed exactly as provided without computing a new deterministic table.

When should I decompose tasks to optimize subagent context management?▼

You should decompose tasks to optimize subagent context management when a token usage report identifies high-cost subagents or indicates context utilization thresholds have been exceeded.

Does token-report require any external dependencies to analyze session health?▼

Token-report requires no external dependencies to analyze session health, operating without any listed components to compute deterministic token usage tables on demand.

Related Skills

Explore More Data & Analytics Skills→
markshd12-cloudmarkshd12-cloud

session-report

Generate HTML reports of Claude Code session token and cache usage.

Community
Intermediate
mtsatryanmtsatryan
1

agent-organizer

Coordinate multi-agent teams with capability mapping and workload-aware scheduling.

Community
Advanced
CsHengCsHeng
10

subagents

Spawn governed subagents with scoped tool permissions via runAgent.

Community
Intermediate
intraleintrale

Cost

Monitor AI token consumption and costs across sessions, agents, and sprints.

Official
Advanced