Name: token-budget-advisor
Author: Xabilimon1

Imported from Xabilimon1/TBA-Token-Budget-Advisor-Claude-Code (SKILL.md). Install upstream with npx skills add Xabilimon1/TBA-Token-Budget-Advisor-Claude-Code. Copyright stays with the author.

Token Budget Advisor

A skill that intercepts the response flow so the user can make an informed choice about how much depth / how many tokens to spend BEFORE the answer is generated.

Workflow

Step 1: Analyze the prompt

Run the estimator on the user's prompt. The script lives at scripts/token_estimator.py inside this skill's directory.

python3 <SKILL_DIR>/scripts/token_estimator.py --text "USER_PROMPT"

For long prompts or prompts containing quotes, use a temp file:

cat > /tmp/_tba_prompt.txt << 'PROMPT_EOF'
USER_PROMPT
PROMPT_EOF
python3 <SKILL_DIR>/scripts/token_estimator.py --file /tmp/_tba_prompt.txt

Replace <SKILL_DIR> with the real install path (usually .claude/skills/token-budget-advisor or whatever appears in your config).

The script returns JSON with: input_tokens, detected_language, detected_type, complexity, response_estimates (per level 25/50/75/100), and total_estimates.

Step 2: Present the options to the user

Show the information clearly BEFORE answering the real prompt. See references/calibration.md for what each level includes and omits.

Recommended format:

Prompt analysis
---------------
Input: ~X tokens | Type: [type] | Complexity: [level]

Choose your depth level:

[1] Essential   (25%)  -> ~Y tokens   Direct answer only
[2] Moderate    (50%)  -> ~Z tokens   Answer + context + 1 example
[3] Detailed    (75%)  -> ~W tokens   Full answer with alternatives
[4] Exhaustive (100%)  -> ~V tokens   Everything, no limits

Heuristic estimate (~85-90% accuracy, +/- 15%).

Step 3: Wait for the choice

Ask the user which level they prefer. In Claude Code's terminal, render the options as plain text and wait for their reply.

Step 4: Respond at the chosen level

Level	Length	What to include
25% Essential	2-4 sentences max	Just the direct answer. No preamble.
50% Moderate	1-3 paragraphs	Answer + minimal context + 1 example if relevant.
75% Detailed	Structured response	Multiple examples, pros/cons, alternatives.
100% Exhaustive	No limit	Everything: full analysis, complete code, every perspective.

Shortcuts

If the user already states a level, do not ask -- just answer at that level:

"at 25%" / "al 25%" / "short version" / "tldr" / "summary" -> 25%
"at 50%" / "al 50%" / "moderate" / "normal" -> 50%
"at 75%" / "al 75%" / "detailed" / "complete" -> 75%
"at 100%" / "al 100%" / "exhaustive" / "everything" / "no limit" -> 100%

If the user picked a level in a previous message of the same session, keep that level for subsequent responses without asking again -- unless they ask to change it.

Install token-budget-advisor and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xabilimon1-tba-token-budget-advisor-claude-code-token-bu-a82f25", "kind": "skill", "name": "token-budget-advisor", "description": "Analyze prompts and offer depth / token-budget options BEFORE answering. Use this skill when the user wants to control token usage, tune response depth, choose between short and long answers, or optimize their prompt. Triggers on: \"tokens\", \"token budget\", \"depth\", \"consumption\", \"short vs long answer\", \"how many tokens\", \"save tokens\", \"answer at 50%\", \"give me the short version\", \"I want to control how much you use\", \"tune your response\", \"presupuesto de tokens\", \"profundidad\", \"responde al 50%\", \"dame la versión corta\", or any equivalent phrasing in English or Spanish. If the user wants to control length, detail or depth -- even without mentioning tokens explicitly -- this skill applies.", "publisher": "Xabilimon1", "version": "1.0.0", "capabilities": { "domains": [ "finance", "math" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Analyze prompts and offer depth / token-budget options BEFORE answering. Use this skill when the user wants to control token usage, tune response depth, choose between short and long answers, or optimize their prompt. Triggers on: \"tokens\", \"token budget\", \"depth\", \"consumption\", \"short vs long answer\", \"how many tokens\", \"save tokens\", \"answer at 50%\", \"give me the short version\", \"I want to control how much you use\", \"tune your response\", \"presupuesto de tokens\", \"profundidad\", \"responde al 50%\", \"dame la versión corta\", or any equivalent phrasing in English or Spanish. If the user wants to control length, detail or depth -- even without mentioning tokens explicitly -- this skill applies." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/Xabilimon1/TBA-Token-Budget-Advisor-Claude-Code", "path": "SKILL.md", "ref": "73bdb45552cf39b6b322f84b2b2fe7249d54d7dc", "url": "https://github.com/Xabilimon1/TBA-Token-Budget-Advisor-Claude-Code/blob/73bdb45552cf39b6b322f84b2b2fe7249d54d7dc/SKILL.md", "key": "Xabilimon1/TBA-Token-Budget-Advisor-Claude-Code/SKILL.md" } }, "instructions": "# Token Budget Advisor\n\nA skill that intercepts the response flow so the user can make an informed\nchoice about how much depth / how many tokens to spend BEFORE the answer is\ngenerated.\n\n## Workflow\n\n### Step 1: Analyze the prompt\n\nRun the estimator on the user's prompt. The script lives at\n`scripts/token_estimator.py` inside this skill's directory.\n\n```bash\npython3 <SKILL_DIR>/scripts/token_estimator.py --text \"USER_PROMPT\"\n```\n\nFor long prompts or prompts containing quotes, use a temp file:\n\n```bash\ncat > /tmp/_tba_prompt.txt << 'PROMPT_EOF'\nUSER_PROMPT\nPROMPT_EOF\npython3 <SKILL_DIR>/scripts", "cost": { "context_tokens": 693 } }

token-budget-advisor

About