context-budget

Überblick über den context-budget skill

Was der context-budget skill macht

Der context-budget skill analysiert, wie viel Claude Code-Session-Kontext durch Agents, Skills, Rules und MCP-Server verbraucht wird. Seine Aufgabe ist einfach: erkennen, wo Tokens ausgegeben werden, einschätzen, was tatsächlich teuer ist, und daraus priorisierte Aufräummaßnahmen machen statt vager Empfehlungen wie „Prompt kürzen“.

Für wen sich context-budget installieren sollte

Dieser Skill eignet sich vor allem für alle, die ein nicht-triviales Claude Code-Setup pflegen: mehrere eigene Agents, einen wachsenden skills/-Ordner, geschichtete Rule-Dateien oder mehrere MCP-Server. Wenn sich Sessions langsamer anfühlen, Ausgaben driften oder du nicht sicher bist, ob ein weiteres Tool die Qualität verschlechtert, ist context-budget ein sehr guter Fit. Bei minimalistischen Setups mit nur wenigen Dateien bringt er deutlich weniger.

Warum Nutzer ihn einem generischen Prompt vorziehen

Ein generischer Audit-Prompt kann das Modell zwar auffordern, „nach Bloat zu suchen“, aber context-budget liefert einen strukturierten Ablauf: Komponenten inventarisieren, Token-Last schätzen, typische Engpässe markieren, doppelte Skills nicht doppelt zählen und die größten Einsparpotenziale priorisiert ausgeben. Genau deshalb ist der context-budget skill auch für Skill Testing nützlich: Er reduziert Rätselraten und schafft einen wiederholbaren Prüfpfad.

Wichtige Grenzen vor der Installation

Das ist ein Skill für Schätzung und Triage, kein Byte-genauer Tokenizer und auch kein automatisches Refactoring-Tool. Er konzentriert sich auf praktische Hinweise auf Overhead wie zu große Dateien, ausführliches Frontmatter, überlappende Rules und MCP-Server mit vielen Tools. Wenn du exakte Token-Zählung zur Laufzeit brauchst, solltest du seine Werte als Richtwerte verstehen und damit gezielt festlegen, was du manuell prüfen willst.

So verwendest du den context-budget skill

Installiere context-budget in deinen Skill-Workflow

Das Repository bietet kein separates Paket nur für diesen Skill. In der Praxis installiert man ihn aus dem übergeordneten Repo und ruft von dort den context-budget skill auf. Ein gängiger Startpunkt ist:

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

Prüfe danach, ob der Skill unter deinen installierten Skills auftaucht, und öffne skills/context-budget/SKILL.md im Source-Repo, wenn du den vorgesehenen Audit-Ablauf verstehen willst, bevor du ihn ausführst.

Welche Eingaben der context-budget skill braucht

Der context-budget skill arbeitet am besten, wenn du ihn auf eine echte Claude-Code-Workspace-Struktur ansetzt. Nützliche Eingaben sind unter anderem:

• agents/*.md
• skills/*/SKILL.md
• rules/**/*.md
• .mcp.json oder die aktive MCP-Konfiguration
• Hinweise darauf, welche Komponenten in normalen Sessions tatsächlich geladen werden

Frag nicht nur: „Audit my context.“ Besser ist: „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.“

Forme aus einem groben Ziel einen starken context-budget-Prompt

Ein schwacher Prompt verlangt eine allgemeine Zusammenfassung. Eine starke Nutzung von context-budget definiert dagegen Umfang, Ausgabeformat und Entscheidungskriterien. Beispiel:

„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.“

Dieser Prompt verbessert die Qualität, weil er den Skill zwingt, Messung, Deduplizierung und Priorisierung sauber zu trennen.

Bester Workflow und was du zuerst lesen solltest

Lies zuerst SKILL.md; dort steht die komplette Methode. Achte besonders auf:

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

Im Einsatz ist der beste Workflow:

1. Einen breiten Auditlauf starten.
2. Die größten Engpässe manuell verifizieren.
3. Jeweils nur eine Kategorie entfernen oder konsolidieren.
4. Den context-budget skill nach jeder Änderung erneut ausführen.

So verhinderst du, dass große Aufräumaktionen nützliche Funktionen kaputtmachen, und gewinnst trotzdem schnell wieder Kontextspielraum zurück.

context-budget skill FAQ

Lohnt sich context-budget bei einem kleinen Setup?

Meistens nicht. Wenn du nur wenige Skills und kein MCP-Wildwuchs hast, reicht eine normale Sichtprüfung oft aus. Der context-budget skill wird wertvoller, sobald dein Umfeld so viele bewegliche Teile hat, dass versteckter Overhead die Qualität beeinflusst oder spätere Erweiterungen riskant macht.

Worin unterscheidet sich context-budget von einem normalen Repo-Review-Prompt?

Ein normaler Prompt prüft oft die inhaltliche Qualität; context-budget prüft die Kontextkosten. Er ist auf Overhead-Quellen zugeschnitten, die leicht übersehen werden, etwa doppelt installierte Skills, zu lange Beschreibungen, überlappende Rules und die Masse von MCP-Tool-Schemata. Genau dieser engere Fokus macht ihn oft besser als eine breite Anfrage wie „optimiere mein Setup“.

Können Einsteiger den context-budget skill nutzen?

Ja, wenn sie ihre Claude-Code-Konfigurationsdateien und -Ordner identifizieren können. Tiefes Tokenisierungswissen brauchst du nicht. Das wichtigste Einsteiger-Risiko ist, nach Warnungen zu „großen Dateien“ nützliche Hinweise vorschnell zu löschen. Nutze den Skill, um Kandidaten zu priorisieren, und prüfe dann die wichtigsten Stellen, bevor du etwas entfernst.

Wann sollte ich context-budget nicht verwenden?

Lass ihn weg, wenn dein Problem nichts mit Kontextlast zu tun hat, etwa schwache Task-Anweisungen, schlechte Beispiele oder fehlende Berechtigungen. Verzichte auch darauf, wenn du exakte Tokenizer-Mathematik oder automatisierte Änderungen brauchst; der context-budget-Guide dient der Diagnose und Priorisierung, nicht der exakten Abrechnung oder einer Ein-Klick-Behebung.

So verbesserst du den context-budget skill

Gib besseren Repo-Kontext und Annahmen zur aktiven Last an

Der beste Weg, die Ergebnisse von context-budget zu verbessern, ist zu sagen, was in echten Sessions tatsächlich geladen wird. Unterscheide zwischen immer aktiven Rules und selten genutzten, sowie zwischen aktiven MCP-Servern und bloß konfigurierten, aber untätigen Servern. Ohne diese Angaben kann der Skill unwichtige Komponenten überbewerten und echte Engpässe unterschätzen.

Bitte um priorisierte Abwägungen, nicht nur Rohzahlen

Reine Token-Schätzungen reichen nicht aus. Bitte den context-budget skill, Funde nach Wirkung, Aufwand und Risiko zu bewerten. Zum Beispiel: „Prefer recommendations that save meaningful context without removing unique capabilities.“ So vermeidest du schlechte Empfehlungen wie das Löschen eines langen, aber unverzichtbaren Skills, bevor du doppelten Rule-Text kürzt.

Achte auf typische Fehlermuster

Die größten Fehlermuster sind doppeltes Zählen gespiegelter Dateien, die Annahme, dass alle Tools gleich teuer sind, und die Vorstellung, große Dateien seien automatisch Verschwendung. Bitte den Skill ausdrücklich darum, zu trennen zwischen:

• dupliziertem und einzigartigem Inhalt
• statischem Overhead und häufig genutztem Kontext
• aufgeblähtem Frontmatter und notwendigen Betriebsanweisungen

So wird die Ausgabe entscheidungsreif.

Führe context-budget nach jeder Bereinigung erneut aus

Führe nicht viele Änderungen auf einmal durch und hoffe auf das Beste. Nutze den context-budget skill iterativ: Audit, eine Gruppe ändern, erneut auditieren, vergleichen. So siehst du, ob die Bereinigung wirklich nutzbaren Kontextspielraum geschaffen hat oder nur Komplexität verschoben wurde. Für Skill Testing sind iterative Läufe der schnellste Weg zu prüfen, ob der Skill ein reales Arbeits-Setup verbessert statt nur einen Einmalbericht zu erzeugen.