Communitygithub.com

Conseiller en Budget de Jetons (TBA)

Intercepte le flux de réponse pour offrir à l'utilisateur un choix sur la profondeur de la réponse avant que Claude ne réponde.

Qu'est-ce que Conseiller en Budget de Jetons (TBA) ?

Token Budget Advisor (TBA) est une compétence pour agents IA (comme Claude Code, Cursor ou Codex) qui permet à l'utilisateur de contrôler la longueur et le détail des réponses avant même qu'elles ne soient générées. Elle est particulièrement utile lorsque l'utilisateur mentionne des jetons, un budget, la profondeur ou la longueur d'une réponse, ou utilise des expressions comme « version courte », « tldr », « bref », « à 25 % », « exhaustif », etc. TBA estime le nombre de jetons de l'entrée à l'aide d'heuristiques simples (mots × 1.3 pour la prose, caractères / 4 pour le code), classe la complexité de la requête (de Simple à Créative) et calcule une fenêtre de réponse potentielle. Elle présente ensuite quatre niveaux de profondeur (Essentiel 25 %, Modéré 50 %, Détaillé 75 %, Exhaustif 100 %) avec des estimations de jetons, et l'utilisateur choisit avant que la réponse ne soit générée. La compétence prend en charge des raccourcis (par exemple, « 2 », « 50 % de profondeur », « réponse équilibrée ») et conserve silencieusement le niveau choisi pour les réponses suivantes de la session. Elle fonctionne sur tous les agents disposant d'un fichier SKILL.md et suit des règles précises pour savoir quand se déclencher ou non (par exemple, ne pas se déclencher si l'utilisateur a déjà défini un niveau dans la session).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/token-budget-advisor

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Conseiller en Budget de Jetons (TBA) ?

Intercepte le flux de réponse pour offrir à l'utilisateur un choix sur la profondeur de la réponse avant que Claude ne réponde.

Quand l'utiliser

  • L'utilisateur souhaite contrôler la longueur ou le détail d'une réponse
  • L'utilisateur mentionne des jetons, un budget, la profondeur ou la longueur de la réponse
  • L'utilisateur dit « version courte », « tldr », « bref », « à 25 % », « exhaustif », etc.
  • À tout moment où l'utilisateur veut choisir le niveau de profondeur/détail en amont

Ne pas déclencher quand : l'utilisateur a déjà défini un niveau dans cette session (le maintenir silencieusement), ou la réponse est trivialement une seule ligne.

Comment ça fonctionne

Étape 1 — Estimer les jetons d'entrée

Utilisez les heuristiques canoniques du budget de contexte du dépôt pour estimer mentalement le nombre de jetons de l'invite.

Utilisez le même guide d'étalonnage que context-budget :

  • prose : mots × 1.3
  • code lourd ou mixte/blocs de code : caractères / 4

Pour un contenu mixte, utilisez le type de contenu dominant et gardez l'estimation heuristique.

Étape 2 — Estimer la taille de la réponse par complexité

Classez l'invite, puis appliquez la plage de multiplicateurs pour obtenir la fenêtre de réponse complète :

ComplexitéPlage de multiplicateursExemples d'invites
Simple3× – 8׫ Qu'est-ce que X ? », oui/non, fait unique
Moyenne8× – 20׫ Comment fonctionne X ? »
Moyenne-Élevée10× – 25×Demande de code avec contexte
Complexe15× – 40×Analyse multi-parties, comparaisons, architecture
Créative10× – 30×Histoires, essais, écriture narrative

Fenêtre de réponse = jetons_entrée × mult_min à jetons_entrée × mult_max (mais ne dépassez pas la limite de jetons de sortie configurée de votre modèle).

Étape 3 — Présenter les options de profondeur

Présentez ce bloc avant de répondre, en utilisant les nombres estimés réels :

Analyse de votre invite...

Entrée : ~[N] jetons  |  Type : [type]  |  Complexité : [niveau]  |  Langue : [langue]

Choisissez votre niveau de profondeur :

[1] Essentiel   (25%)  ->  ~[jetons]   Réponse directe uniquement, sans préambule
[2] Modéré      (50%)  ->  ~[jetons]   Réponse + contexte + 1 exemple
[3] Détaillé    (75%)  ->  ~[jetons]   Réponse complète avec alternatives
[4] Exhaustif  (100%)  ->  ~[jetons]   Tout, sans limites

Quel niveau ? (1-4 ou dites « profondeur 25% », « profondeur 50% », « profondeur 75% », « profondeur 100% »)

Précision : estimation heuristique ~85-90% (±15%).

Estimations de jetons par niveau (dans la fenêtre de réponse) :

  • 25% → min + (max - min) × 0.25
  • 50% → min + (max - min) × 0.50
  • 75% → min + (max - min) × 0.75
  • 100% → max

Étape 4 — Répondre au niveau choisi

NiveauLongueur cibleInclureOmettre
Essentiel 25 %2-4 phrases maxRéponse directe, conclusion cléContexte, exemples, nuance, alternatives
Modéré 50 %1-3 paragraphesRéponse + contexte nécessaire + 1 exempleAnalyse approfondie, cas limites, références
Détaillé 75 %Réponse structuréeExemples multiples, avantages/inconvénients, alternativesCas limites extrêmes, références exhaustives
Exhaustif 100 %Aucune restrictionTout — analyse complète, tout le code, toutes les perspectivesRien

Raccourcis — ignorer la question

Si l'utilisateur signale déjà un niveau, répondez immédiatement à ce niveau sans demander :

Ce qu'ils disentNiveau
« 1 » / « profondeur 25% » / « version courte » / « réponse brève » / « tldr »25 %
« 2 » / « profondeur 50% » / « profondeur modérée » / « réponse équilibrée »50 %
« 3 » / « profondeur 75% » / « réponse détaillée » / « réponse approfondie »75 %
« 4 » / « profondeur 100% » / « réponse exhaustive » / « plongée complète »100 %

Si l'utilisateur a défini un niveau plus tôt dans la session, maintenez-le silencieusement pour les réponses suivantes, sauf s'il le change.

Note de précision

Cette compétence utilise une estimation heuristique — pas de tokenizer réel. Précision ~85-90 %, variance ±15 %. Toujours afficher la clause de non-responsabilité.

Exemples

Déclencheurs

  • « Donne-moi d'abord la version courte. »
  • « Combien de jetons ta réponse utilisera-t-elle ? »
  • « Réponds à 50 % de profondeur. »
  • « Je veux la réponse exhaustive, pas le résumé. »
  • « Donne-moi la version courte puis la version détaillée. »

Ne se déclenche pas

  • « Qu'est-ce qu'un jeton JWT ? »
  • « Le flux de paiement utilise un jeton de paiement. »
  • « Est-ce normal ? »
  • « Termine la refactorisation. »
  • Questions de suivi après que l'utilisateur a déjà choisi un niveau pour la session

Source

Compétence autonome de TBA — Token Budget Advisor for Claude Code. Le projet original inclut également un script d'estimation Python, mais ce dépôt garde la compétence autonome et basée uniquement sur des heuristiques.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Skills associés