context-budget

Vue d’ensemble de la skill context-budget

Ce que fait la skill context-budget

La skill context-budget analyse la part du contexte de session Claude Code consommée par les agents, les skills, les règles et les serveurs MCP. Son rôle est simple : repérer où partent les tokens, estimer ce qui coûte réellement cher, puis transformer cela en actions de nettoyage priorisées au lieu de recommandations vagues du type « réduire la taille du prompt ».

À qui s’adresse context-budget

Cette skill est surtout utile aux personnes qui maintiennent une configuration Claude Code déjà conséquente : plusieurs agents personnalisés, un dossier skills/ qui s’étoffe, des fichiers de règles en couches, ou plusieurs serveurs MCP. Si vos sessions paraissent plus lentes, si les sorties dérivent, ou si vous ne savez pas si l’ajout d’un outil supplémentaire va dégrader la qualité, context-budget est un très bon choix. Elle apporte en revanche moins de valeur sur des configurations minimales avec seulement quelques fichiers.

Pourquoi les utilisateurs la choisissent plutôt qu’un prompt générique

Un prompt d’audit générique peut demander au modèle de « chercher les éléments superflus », mais context-budget apporte un workflow structuré : inventorier les composants, estimer la charge en tokens, signaler les points chauds fréquents, éviter de compter deux fois des skills copiées, puis produire une liste hiérarchisée d’économies possibles. C’est ce qui rend la skill context-budget utile pour le Skill Testing : elle réduit la part d’intuition et crée un processus de revue reproductible.

Limites importantes à connaître avant l’installation

Il s’agit d’une skill d’estimation et de triage, pas d’un tokenizer exact au byte près ni d’un outil de refactorisation automatique. Elle se concentre sur des signaux de surcharge concrets, comme les fichiers trop volumineux, les frontmatters verbeux, les règles qui se recouvrent et les serveurs MCP avec beaucoup d’outils. Si vous avez besoin d’un comptage exact des tokens à l’exécution, considérez ses chiffres comme des ordres de grandeur servant à prioriser ce qu’il faut inspecter manuellement.

Comment utiliser la skill context-budget

Installer context-budget dans votre workflow de skills

Le dépôt ne propose pas de package séparé pour cette skill. En pratique, les utilisateurs l’installent depuis le repo parent puis appellent la skill context-budget à partir de là. Un point de départ courant est :

npx skills add affaan-m/everything-claude-code --skill context-budget

Ensuite, vérifiez que la skill est bien présente dans vos skills installées, puis ouvrez skills/context-budget/SKILL.md dans le repo source si vous voulez comprendre le déroulé d’audit prévu avant de l’exécuter.

Quelles entrées fournir à la skill context-budget

La skill context-budget fonctionne nettement mieux si vous la pointez vers une vraie structure de workspace Claude Code. Entrées utiles :

• agents/*.md
• skills/*/SKILL.md
• rules/**/*.md
• .mcp.json ou la configuration MCP active
• des notes indiquant quels composants sont réellement chargés dans les sessions normales

Évitez de demander simplement « audit my context ». Préférez : « Audit token overhead across agents/, skills/, rules/, and .mcp.json. Estimate heavy files, duplicated skills, overlapping rules, and MCP tool schema cost. Return top 5 savings ranked by impact vs effort. »

Transformer un objectif flou en bon prompt context-budget

Un prompt faible demande un résumé générique. Un bon prompt d’usage de context-budget définit le périmètre, le format de sortie et les critères de décision. Exemple :

“Use the context-budget skill on this repo. Inventory all agents, skills, rules, and MCP servers. Estimate token consumption with clear assumptions, skip identical duplicated skills if mirrored under .agents/skills/, flag heavy files and redundant rule content, and recommend immediate, medium, and low-priority cuts. Include likely savings and risk of removing each item.”

Ce prompt améliore la qualité, car il oblige la skill à distinguer la mesure, la déduplication et la priorisation.

Meilleur workflow avec context-budget et fichiers à lire en priorité

Lisez d’abord SKILL.md ; c’est là que se trouve la méthode complète. Concentrez-vous sur :

1. When to Use
2. How It Works
3. Phase 1: Inventory
4. Phase 2 classification and recommendations

En pratique, le workflow le plus efficace est :

1. Lancer un audit large.
2. Vérifier manuellement les points chauds les plus importants.
3. Supprimer ou consolider une catégorie à la fois.
4. Relancer la skill context-budget après chaque modification.

Cette approche évite qu’un gros nettoyage ne casse des comportements utiles, tout en récupérant rapidement de la marge dans le contexte.

FAQ sur la skill context-budget

context-budget vaut-elle le coup sur une petite configuration ?

En général, non. Si vous n’avez que quelques skills et pas de prolifération côté MCP, une inspection classique suffit souvent. La skill context-budget devient vraiment intéressante quand votre environnement comporte assez d’éléments mobiles pour que la surcharge cachée affecte la qualité ou rende les ajouts futurs risqués.

En quoi context-budget diffère-t-elle d’un prompt classique de revue de repo ?

Un prompt classique examine souvent la qualité du contenu ; context-budget examine le coût en contexte. Elle est réglée pour repérer des sources de surcharge faciles à manquer, comme les skills installées en double, les descriptions trop longues, les règles qui se chevauchent et le volume des schémas d’outils MCP. C’est précisément grâce à ce cadrage plus étroit qu’elle peut faire mieux qu’une demande large du type « optimise ma configuration ».

Les débutants peuvent-ils utiliser la skill context-budget ?

Oui, à condition de savoir identifier leurs dossiers et fichiers de configuration Claude Code. Il n’est pas nécessaire d’avoir une connaissance poussée de la tokenisation. Le principal risque pour un débutant est de supprimer trop de guidage utile après avoir vu des alertes « large file ». Utilisez la skill pour classer les candidats, puis inspectez les éléments à fort impact avant toute suppression.

Dans quels cas ne faut-il pas utiliser context-budget ?

Évitez-la si votre problème de comportement du modèle n’a rien à voir avec la charge de contexte, par exemple des consignes de tâche faibles, de mauvais exemples ou des permissions manquantes. Évitez-la aussi si vous avez besoin d’un calcul exact des tokens par tokenizer ou de modifications automatisées ; le guide context-budget sert au diagnostic et à la priorisation, pas à la comptabilité exacte ni à la remédiation en un clic.

Comment améliorer la skill context-budget

Donner à context-budget un meilleur contexte de repo et des hypothèses de charge active

Le meilleur moyen d’améliorer les résultats de context-budget est d’indiquer ce qui est réellement chargé dans les sessions normales. Distinguez les règles toujours actives de celles rarement utilisées, ainsi que les serveurs MCP actifs de ceux qui sont configurés mais inactifs. Sans cela, la skill peut surestimer des composants peu impactants et sous-estimer les vrais goulots d’étranglement.

Demander des arbitrages classés, pas seulement des volumes bruts

Des estimations brutes de tokens ne suffisent pas. Demandez à la skill context-budget d’évaluer les résultats selon l’impact, l’effort et le risque. Par exemple : “Prefer recommendations that save meaningful context without removing unique capabilities.” Cela permet d’éviter de mauvais conseils, comme supprimer une skill longue mais essentielle avant d’alléger un texte de règle dupliqué.

Surveiller les modes d’échec fréquents

Les principaux modes d’échec sont le double comptage de fichiers en miroir, le fait de considérer tous les outils comme également coûteux, et l’hypothèse qu’un gros fichier est automatiquement inutilement lourd. Demandez explicitement à la skill de distinguer :

• le contenu dupliqué du contenu unique
• la surcharge statique du contexte réellement utilisé souvent
• le frontmatter gonflé des instructions opérationnelles réellement nécessaires

Le résultat sera alors plus directement exploitable pour décider.

Relancer context-budget après chaque nettoyage

N’enchaînez pas de nombreuses modifications d’un coup en espérant que tout ira bien. Utilisez la skill context-budget de façon itérative : audit, modification d’un seul groupe, nouvel audit, comparaison. C’est la meilleure façon de voir si le nettoyage a vraiment libéré de l’espace de contexte exploitable ou s’il a simplement déplacé la complexité ailleurs. Pour le Skill Testing, ces passes itératives sont la manière la plus rapide de vérifier que la skill améliore une vraie configuration de travail, au lieu de produire un rapport ponctuel sans suite.