token-budget-advisor

Estimate input tokens and present four depth levels with token estimates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Maelwalser/claude-config --skill token-budget-advisor-maelwalser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: token-budget-advisor
Source: https://github.com/Maelwalser/claude-config/tree/main/skills/token-budget-advisor
Command: npx skills add https://github.com/Maelwalser/claude-config --skill token-budget-advisor-maelwalser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many users want control over how long or detailed an AI response will be but lack a simple way to choose depth before the model generates text. Token Budget Advisor intercepts the flow to estimate token usage and present clear depth options so users can pick brevity or exhaustiveness up front.

Core Features & Use Cases

  • Heuristic token estimation based on prose or code-dominant heuristics to approximate input size.
  • Complexity classification and token windowing to produce 25%/50%/75%/100% depth options with numeric token estimates.
  • Session-aware depth persistence that honors previously selected levels silently and supports quick shortcuts like "tldr" or "50% depth".
  • Use Case: When a developer asks for a multi-file refactor plan, the skill offers token-based depth choices so the developer can request a concise checklist or an exhaustive implementation guide.

Quick Start

Ask the assistant to estimate tokens and present depth options before answering your prompt.

Frequently Asked Questions about token-budget-advisor

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

FAQPage Schema
How do I control AI response length before the model generates text?

To control AI response length, a pre-answer depth selection intercepts your prompt to estimate input tokens and present four depth options with token estimates before the model answers. This allows you to choose the exact response detail level upfront.

How do I estimate input tokens for a coding or conversational prompt?

Input tokens are estimated heuristically by differentiating between prose-dominant and code-dominant text. This heuristic estimation approximates the input size to calculate token windows and present accurate depth choices for your specific prompt.

Can I set a persistent response depth level across multiple prompts in a session?

Yes, you can set a persistent response depth level across multiple prompts using session-aware depth persistence. Once you select a level, the system honors it silently for subsequent prompts, and you can use shortcuts like tldr or 50% depth for quick changes.

What is the best way to get a concise checklist instead of an exhaustive implementation guide for a multi-file refactor plan?

The best way to get a concise checklist instead of an exhaustive guide is to request token-based depth choices before the refactor plan is generated. This presents options ranging from brief summaries to exhaustive details, letting you select the exact output length.

Does token budget estimation work without external dependencies or API calls?

Yes, token budget estimation works without external dependencies because it uses internal heuristic logic. It estimates input size and calculates token windows by classifying prompt complexity directly, functioning as a standalone pre-answer depth selection mechanism.