token-coach

Coach Claude Code architecture and token budgeting using measure.py outputs.

1.8k|149|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/alexgreensh/token-optimizer --skill token-coach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: token-coach
Source: https://github.com/alexgreensh/token-optimizer/tree/main/skills/token-coach
Command: npx skills add https://github.com/alexgreensh/token-optimizer --skill token-coach

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Token Coach provides proactive guidance to optimize token usage for Claude Code projects, multi-agent systems, and skill architecture, helping teams reduce startup overhead and improve session quality.

Core Features & Use Cases

  • Architecture-focused coaching to reduce context overhead, model routing choices, and skill management.
  • Reference-driven patterns for multi-agent design, CLAUDE.md layering, and memory hygiene, with practical anti-patterns and quick wins.
  • Use cases include building new projects, optimizing existing setups, and validating health checks with measurable savings.

Quick Start

Provide your goal in one sentence and start with a quick overhead assessment to identify top token-saving actions.

Frequently Asked Questions about token-coach

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

FAQPage Schema
How do I reduce token overhead in Claude Code sessions?

To reduce token overhead in Claude Code sessions, apply proactive coaching on architecture, token budgeting, and pattern selection. This approach guides you through model routing choices and skill management to significantly lower startup costs and context bloat.

What is the best way to optimize token usage for multi-agent setups?

Optimizing token usage for multi-agent setups involves applying reference-driven patterns for multi-agent design and memory hygiene. By health-checking existing configurations, you can identify anti-patterns and achieve measurable token savings across agents.

How do I start a token budget assessment for a new Claude Code project?

To start a token budget assessment for a new Claude Code project, provide your project goal in one sentence and request a quick overhead assessment. This identifies top token-saving actions and guides architecture decisions immediately.

Does token coaching work with existing Claude Code configurations?

Yes, token coaching works with existing Claude Code configurations by performing health checks on your current setup. It integrates with measure.py outputs and coaching references to validate your configurations and provide measured guidance for optimization.

Why does my Claude Code session use so many tokens during startup?

Your Claude Code session uses excessive tokens during startup due to context overhead and poor CLAUDE.md layering. By applying memory hygiene practices and reference-driven architecture patterns, you can eliminate unnecessary context bloat and improve session quality.