Claude Code Skills: Kontextkosten mit /skill-doctor senken

Jetzt lässt sich erkennen, welche Claude Code Skills Kontext verbrauchen, ohne zur eigentlichen Arbeit beizutragen – und wie sich diese Kosten beseitigen lassen, ohne Anweisungen zu verlieren, die reale Workflows weiterhin benötigen. Der neue Bericht /skill-doctor macht aus der Skill-Bereinigung eine messbare, reversible Routine statt bloßer Vermutung.

Die Kurzfassung: /skill-doctor ausführen, jeden ungenutzten Skill danach einordnen, wie schwer sein Verlust wiegen würde, die am wenigsten einschneidende Sichtbarkeitsänderung wählen und das Ergebnis in einer frischen Sitzung testen. Ordner sollten nicht als Erstes gelöscht werden. Ein Skill, der eine Woche lang still bleibt, kann trotzdem genau der Schutzmechanismus sein, der ein Deployment oder die Reaktion auf einen Vorfall absichert.

Claude Code 2.1.261, veröffentlicht am 4. September 2026, führte /skill-doctor ein. Der Befehl zeigt, welche geladenen Skills ungenutzt bleiben und wie viel Kontext jeder einzelne kostet. Das ist relevant, weil jeder aufgeführte Skill in jedem Turn mindestens seinen Namen und normalerweise auch eine Beschreibung beisteuert – selbst wenn Claude seine vollständigen Anweisungen nie aufruft.

Was Kontextkosten bei Claude Code Skills wirklich bedeuten

Bei Skill-Kontext fallen zwei Arten von Kosten an. Wer beide in einen Topf wirft, bereinigt an der falschen Stelle.

Der erste Posten sind die Listing-Kosten. Noch bevor eine Eingabe erfolgt, sieht Claude die Namen und Beschreibungen der verfügbaren Skills, damit es den passenden Skill für die Anfrage auswählen kann. Anthropic begrenzt dieses Listing standardmäßig auf 1% des Kontextfensters des Modells. Außerdem sind description und when_to_use eines Skills zusammen standardmäßig auf 1,536 Zeichen begrenzt.

Der zweite Posten sind die Aufrufkosten. Der vollständige Inhalt von SKILL.md wird erst geladen, wenn der Skill durch eine Person oder Claude aufgerufen wird. Danach bleibt er über weitere Turns hinweg Bestandteil der Unterhaltung. Nach einer Komprimierung kann Claude Code aus jedem aufgerufenen Skill bis zu 5,000 Tokens erneut anhängen; für alle wieder angehängten Skills zusammen gilt ein Budget von 25,000 Tokens.

Das Listing lässt sich mit einem Schaufenster vergleichen, der Skill-Inhalt mit der Ware, die an die Theke geholt wird. Jedes Ladenschild beansprucht Platz auf der Straße. Die Ware braucht erheblich mehr Platz, aber erst dann, wenn jemand danach fragt.

Aus diesem Unterschied ergibt sich auch die passende Gegenmaßnahme. Ein ungenutzter Skill mit langer Beschreibung erzeugt fortlaufende Listing-Kosten. Ein häufig aufgerufener Skill mit sehr großem Inhalt belastet dagegen die gesamte Sitzung. /skill-doctor hilft vor allem beim ersten Problem; für das zweite braucht es eine gute Skill-Architektur.

Claude Code: Kosten entstehen pro Turn, nicht pro Installation

Ein ungenutzter Skill ist keine einmalige Einrichtungsausgabe. Sein Listing-Text wird im weiteren Verlauf der Unterhaltung immer wieder vorgelegt. Als brauchbare Arbeitsschätzung dient:

Vermeidbarer Kontext pro Tag = ungenutzte Listing-Tokens pro Turn × Claude-Turns pro Tag

Weist der Bericht beispielsweise 2,000 Tokens ungenutzten Listing-Kontext aus und entstehen bei der Arbeit 40 Modell-Turns, werden über den Tag 80,000 Input-Tokens vorgelegt. Das ist ein Rechenbeispiel, kein Benchmark. Prompt-Caching kann den abgerechneten Preis wiederholter Texte senken, lässt den belegten Kontext aber nicht verschwinden.

Für API- und Cloud-Nutzer schlagen diese zusätzlichen Tokens auf die Rechnung durch. Bei Abonnements verbrauchen sie Kontingent und verkleinern den Arbeitsraum bis zur nächsten Komprimierung. Laut Anthropic liegen Claude-Code-Deployments in Unternehmen im Durchschnitt bei rund $13 pro Entwickler und aktivem Tag sowie $150 bis $250 pro Entwickler und Monat. Verschwendung durch Skills ist nur ein Teil dieser Ausgaben, gehört nun aber zu den wenigen Posten, die sich namentlich isolieren lassen.

Nicht nur das Modellbudget leidet. Ebenso betroffen ist der Durchsatz der Entwicklung. Ein überfülltes Listing kann Claude Code dazu zwingen, die Beschreibungen der am seltensten genutzten Skills wegzulassen. Das spart Platz, erschwert Claude aber zugleich deren automatische Auswahl.

Claude Code Skills sicher bereinigen, prüfen und wiederherstellen

Ein sicherer Workflow besteht aus sieben Schritten.

1. Mit einer aktuellen Terminalsitzung beginnen

Zunächst auf Claude Code 2.1.261 oder neuer aktualisieren und die installierte Version mit claude --version prüfen. Laut Anthropic-Referenz setzt /skill-doctor mindestens 2.1.252 voraus; 2.1.261 ist die Changelog-Version, mit der der Befehl angekündigt wurde.

/skill-doctor wird im Terminal auf dem Rechner ausgeführt, auf dem die Sitzung läuft. In einer interaktiven Sitzung öffnet sich der Bericht im Tab Stats des /plugin-Managers. Im nicht interaktiven Modus mit -p erscheint er als Text und lässt sich dadurch gut für ein lokales Audit erfassen. Über Remote Control kann der Bericht nicht abgerufen werden.

2. Den Ausgangswert festhalten

Vor jeder Änderung sollten drei Dinge gesichert werden: die gesamten Listing-Kosten der Skills, die größten ungenutzten Verursacher und die Skills oder Plugins, die geändert werden sollen. Zusätzlich zeigt /context in der Zeile Skills den Stand nach Anwendung des Budgets; mit /doctor lassen sich die größten Beiträge zum Listing ermitteln.

Tokenzahlen sollten nur dann direkt in Geldbeträge übersetzt werden, wenn Modell, Cache-Verhalten und vereinbarte Preise bekannt sind. Tokens sind die stabile Maßeinheit; die Kostenrechnung erfolgt separat.

3. Kandidaten nach den Folgen eines Ausfalls sortieren

Jeder Kandidat gehört in eine von drei Kategorien:

An dieser Stelle braucht der Bericht menschliches Urteil. „Nie aufgerufen“ misst die Häufigkeit, nicht den Wert. Auch ein nie benutzter Feuerlöscher kann es wert sein, aufbewahrt zu werden.

4. Die am wenigsten einschneidende Einstellung wählen

Bei lokalen, persönlichen, projektbezogenen oder synchronisierten Skills kann das Menü /skills eine reversible Änderung an skillOverrides in .claude/settings.local.json schreiben.

• name-only eignet sich, wenn Claude wissen soll, dass der Skill existiert, seine vollständige Beschreibung im Listing aber nicht benötigt.
• user-invocable-only hält /skill-name verfügbar, verhindert jedoch jede automatische Auswahl.
• off ist nur richtig, wenn weder die Person noch Claude den Skill sehen soll.
• on stellt das ursprüngliche Verhalten wieder her.

Wer den Skill selbst verwaltet, erreicht mit disable-model-invocation: true auf Autorenebene portabel dasselbe wie mit einer Richtlinie für ausschließlich manuelle Aufrufe. Die Beschreibung verschwindet aus Claudes Listing, der direkte Aufruf bleibt möglich.

Bei Plugin-Skills gelten andere Regeln: skillOverrides hat auf sie keine Wirkung. Ein Plugin lässt sich ohne Deinstallation mit /plugin disable plugin-name@marketplace-name abschalten und mit /plugin enable plugin-name@marketplace-name wieder aktivieren. Dabei ist zu beachten, dass ein Plugin auch Agenten, Hooks, MCP-Server oder Sprachwerkzeuge mitbringen kann. Vor dem Abschalten sollten daher seine Bestandteile geprüft werden.

5. Inhalte verkleinern, ohne Fähigkeiten zu verlieren

Ist ein nützlicher Skill sehr umfangreich, sollte SKILL.md als kompakter Wegweiser dienen. Ausführliche Beispiele, API-Referenzen und Sonderfälle wandern in unterstützende Dateien. Anthropic empfiehlt, SKILL.md auf weniger als 500 Zeilen zu begrenzen. Unterstützende Dateien werden erst geladen, wenn Claude sie benötigt; Hilfsskripte können sogar ausgeführt werden, ohne dass ihr Quelltext im Prompt landet.

Aufgabe, Trigger, unverhandelbare Regeln und die Übersicht der unterstützenden Dateien gehören an den Anfang. So bleibt der wichtigste Teil auch nach der Komprimierung geschützt, wenn von jedem erneut angehängten Skill nur die ersten 5,000 Tokens erhalten bleiben.

6. In einer frischen Sitzung testen

Eine Änderung am Skill entfernt keine Anweisungen, die bereits in die aktuelle Unterhaltung geladen wurden. Deshalb eine neue Sitzung starten, einige Eingaben ausführen, die den Skill auslösen sollten, und dieselben Eingaben noch einmal mit verborgenem Skill testen. Zuerst zählt der Erfolg der Aufgabe, erst danach die Tokenzahl.

Anthropic empfiehlt Vergleiche in frischen Sitzungen, weil verbliebener Autoren- oder Skill-Kontext verschleiern kann, welchen Beitrag der Skill tatsächlich leistet. Erfordern Plugin-Änderungen /reload-plugins, kostet die nächste Anfrage voraussichtlich zusätzliche Tokens; bei Plugins mit nicht verzögert geladenen MCP-Tools muss möglicherweise auch der Prompt-Cache neu aufgebaut werden.

7. Fehlende Fähigkeiten zurückholen und das Audit wiederholen

Sinkt die Qualität, wird genau eine Stufe zurückgegangen: von off zu user-invocable-only, von dort zu name-only oder von einem deaktivierten zu einem aktivierten Plugin. Bleibt die Qualität stabil, kann der schlankere Zustand bestehen bleiben. Nach einer repräsentativen Phase echter Arbeit folgt ein neuer Lauf von /skill-doctor.

Dieser letzte Durchgang ist wichtig. Das Ziel ist nicht die kleinstmögliche Skill-Liste, sondern die günstigste Liste, die wiederkehrende Aufgaben weiterhin zuverlässig an den richtigen Skill leitet.

Wer am stärksten von niedrigeren Kontextkosten profitiert

Die folgenden Einsatzfelder sind nach ihrer voraussichtlichen wirtschaftlichen Wirkung geordnet.

1. Plattformteams mit einer gemeinsamen Claude-Code-Konfiguration

Ein Plattformverantwortlicher mit Dutzenden Entwicklern kann eine Pilotgruppe lokale /skill-doctor-Berichte exportieren lassen, überall vorhandene, aber nirgends ausgelöste Skills identifizieren und optionale Workflows nur für manuelle Aufrufe oder bestimmte Projekte bereitstellen. Der Effekt summiert sich über jeden Turn aller Entwickler; die Wiederherstellungsdatei hält das Experiment reversibel. Zentral verwaltete Enterprise-Skills fehlen im Bericht, weshalb dieser Ansatz eine lokale Stichprobe der Flotte liefert und kein vollständiges Richtlinien-Audit.

2. Engineering-Teams mit vielen Plugins

Ein Team installiert möglicherweise ein Plugin für eine einzelne Migration und lässt dessen Skills, Agenten, Hooks und MCP-Tools anschließend monatelang aktiv. /skill-doctor macht zuletzt ungenutzte Plugins sichtbar; der Plugin-Manager kann sie deaktivieren, ohne sie zu deinstallieren. Der Nutzen reicht über die Skill-Beschreibung hinaus, da ein ungenutztes Plugin mehrere kontextbelegende Komponenten hinzufügen kann. Ebenso umfassend ist das Risiko: Beim Deaktivieren können auch nützliche Komponenten außerhalb des Skills verschwinden.

3. Beratende mit wechselnden Kunden-Stacks

Beratende führen häufig Frontend-, Daten-, E-Commerce- und Infrastruktur-Skills global mit, obwohl beim aktuellen Kunden nur eine Gruppe relevant ist. Über benannte Profile in den lokalen Einstellungen lässt sich die passende Gruppe einblenden, während seltene Sicherheitsabläufe nur manuell verfügbar bleiben. So beginnt jedes Mandat mit einem aufgeräumten Kontext, ohne jeden Montag das gesamte Toolkit neu aufzubauen.

4. Verantwortliche für große Monorepos

Claude Code kann verschachtelte Skills entdecken, sobald es tiefer liegende Verzeichnisse liest; anschließend bleiben sie für den Rest der Sitzung verfügbar. Nach einer paketübergreifenden Aufgabe kann ein Monorepo-Verantwortlicher ein Audit durchführen, paketspezifische Anweisungen in das passende Unterverzeichnis verschieben und Beschreibungen auf der Root-Ebene kürzen. Das verbessert die Auswahl: Backend-Arbeit muss keine Parade von Beschreibungen für Frontend-Workflows mitführen.

5. Teams mit seltenen, aber kritischen Befehlen

Skills für Deployment, Rollback, Datenmigration und Vorfallbehandlung werden mitunter wochenlang nicht ausgelöst. Nur weil der Bericht sie als ungenutzt ausweist, sollten sie nicht gelöscht werden. Im manuellen Modus verschwinden ihre Beschreibungen aus Claudes wiederkehrendem Listing, während der exakte Notausgang /skill-name erhalten bleibt. Normale Sitzungen benötigen dadurch weniger Kontext, ohne dass das Runbook im Ernstfall neu erstellt werden muss.

6. Skill-Autoren mit umfangreichen Referenzen

Ein Skill-Autor kann mithilfe des Berichts einen teuren Skill finden und lange Beispiele sowie Spezifikationen in unterstützende Dateien auslagern. Die Hauptdatei wird zu einer prägnanten Entscheidungskarte. Der Vorteil: Die Kontextkosten fallen später an, weil Details erst in dem Zweig geladen werden, der sie wirklich benötigt.

7. Solo-Entwickler am Abonnementlimit

Bei Solo-Entwicklern führt die Maßnahme möglicherweise nicht zu einer direkten Ersparnis, weil die Nutzung in Pro und Max enthalten ist. Entscheidend sind mehr Arbeit innerhalb desselben Kontingents und mehr Spielraum bis zur Komprimierung. Sinnvoll ist die Kombination von /skill-doctor mit einer aufgeräumten Claude-Code-Konfiguration; beim Wechsel zu einer fachfremden Aufgabe sollte die Sitzung geleert werden.

Drei Produktideen rund um Claude Code Skills

Der Suchmarkt ist größer, als die neue Suchanfrage vermuten lässt. DataForSEO weist für claude code skills in den USA 12,100 Suchanfragen pro Monat und einen CPC von $8.26 aus. Die engen Suchphrasen zur Senkung der Skill-Kontextkosten lieferten keine Vorschläge. Damit eröffnet sich eine Aktualitätschance innerhalb eines etablierten Skill-Markts – noch keine ausgereifte eigenständige Kategorie.

1. Skill Budget Guard – die stärkste Option

Eine lokal arbeitende CLI mit CI-Prüfung könnte Repository-Skills, Sichtbarkeitseinstellungen und einen exportierten /skill-doctor-Bericht einlesen und für jeden Pull Request die Veränderung des Kontextbedarfs anzeigen. Plattformteams zahlen dafür, weil das Tool aus der Bereinigung eines einzelnen Entwicklers ein wiederholbares Teambudget macht.

Das Nachfragesignal ist ungewöhnlich eindeutig: claude code skills erreicht 12,100 monatliche Suchanfragen bei einem CPC von $8.26. Zugleich nennt Anthropic durchschnittliche Enterprise-Kosten für Claude Code von $150 bis $250 pro Entwickler und Monat. Die kleinste verkaufsfähige Version benötigt einen lokalen Parser, eine eingecheckte Budgetdatei, eine GitHub Action und reversible Vorschläge wie „nur für Benutzer verfügbar machen“ oder „Referenzen auslagern“.

Das offene Risiko ist die Abhängigkeit von der Plattform. Anthropic kann /skill-doctor ausbauen; außerdem ist die Analytics API für berechtigte Organisationen bereits kostenlos. Nachhaltig abgrenzen lässt sich das Produkt durch Richtlinienverläufe, repositoryübergreifende Vergleiche und den Nachweis, dass eine Kontextreduzierung die Erfolgsquote der Aufgaben nicht verschlechtert hat.

2. Projektbezogener Skill Profile Switcher

Benannte Profile wie frontend, data, incident und release könnten skillOverrides mit der Aktivierung oder Deaktivierung von Plugins kombinieren und anschließend den vorherigen Zustand mit einem einzigen Befehl wiederherstellen. Zielgruppe sind Beratende und Monorepo-Teams.

DataForSEO meldet für best claude code skills 590 monatliche Suchanfragen mit kommerzieller Absicht und einem CPC von $11.91. Zum MVP gehören eine Manifestdatei, eine Diff-Vorschau, sichere Änderungen an lokalen Einstellungen, Plugin-Befehle und ein Wiederherstellungspunkt. Der Haken ist der geringe Schutz vor Nachahmung: Die Menüs von Claude Code stellen die zugrunde liegenden Einstellungen bereits bereit, und das erneute Laden von Plugins kann einmalig zusätzliche Cache-Kosten verursachen.

3. Skill Outcome Lab

Ein Testprogramm könnte dieselbe realistische Eingabe in frischen Sitzungen einmal mit und einmal ohne Skill ausführen und anschließend Erfolgsquote, Dauer und Tokenverbrauch vergleichen. Skill-Autoren und interne Enablement-Teams zahlen für den Nachweis, dass eine Anweisung ihren Kontextverbrauch rechtfertigt.

DataForSEO weist für claude code skills best practices 110 monatliche Suchanfragen mit kommerzieller Absicht und Geboten für die obersten Anzeigenplätze von $4.14 bis $6.01 aus. Ein brauchbares MVP braucht Prompt-Fixtures, Prüfungen der erwarteten Ergebnisse, isolierte frische Sitzungen und einen einfachen Vorher-nachher-Bericht.

Der entscheidende Haken: Anthropics offizielles Skill-Creator-Plugin vergleicht bereits Benchmark-Läufe mit und ohne Skill. Diese Funktion gehört deshalb in den Skill Budget Guard und trägt kein eigenständiges Unternehmen.

Wenn ein Team Skills über mehrere Produkte oder Agenten verteilt, ergänzt dieser Vergleich von Notion Skills und der Claude Skills API die Governance-Perspektive der Entscheidung.

Was /skill-doctor nicht löst

/skill-doctor ist ein Profiler für verschwendeten Skill-Listing-Kontext, kein vollständiger Kostenoptimierer für Claude Code.

• Gebündelte oder zentral verwaltete Enterprise-Skills werden nicht geprüft.
• Ein bereits in die aktuelle Unterhaltung geladener Skill-Inhalt wird nicht entfernt.
• CLAUDE.md, ältere Gesprächsverläufe, Modellwahl, Thinking-Tokens, umfangreiche Tool-Ausgaben und MCP-Overhead werden nicht gemessen.
• Über Remote Control lassen sich keine Nutzungsberichte abrufen.
• Der Bericht kann nicht beurteilen, ob ein seltener Skill einen kostspieligen Fehler verhindert hat.
• Zwischengespeicherter Kontext wird dadurch nicht kostenlos. Cache-Preis und Kontextbelegung sind zwei getrennte Fragen.

skillListingBudgetFraction sollte nicht als Erstes gesenkt werden. Überschreitet das Listing sein Budget, behält Claude Code die Namen bei, lässt aber – beginnend mit den am seltensten verwendeten Skills – Beschreibungen weg. Das kann den Listing-Text reduzieren und gleichzeitig die Wahrscheinlichkeit senken, dass der richtige Skill ausgelöst wird. Einträge mit geringem Wert sollten stattdessen gezielt entfernt oder verborgen werden.

Ebenso falsch wäre es, Plugins beim ersten Verdacht zu deinstallieren. Erst deaktivieren, dann testen und nur dann deinstallieren, wenn feststeht, dass auch die übrigen Komponenten des Plugins nicht gebraucht werden.

Der konkrete Schritt für Montag

Ein echtes Repository und einen Entwickler auswählen, der Claude Code intensiv nutzt. /skill-doctor ausführen, die fünf größten ungenutzten Verursacher notieren und nur zwei Änderungen vornehmen: einen seltenen Workflow in den Nur-Benutzer-Modus versetzen und ein nachweislich irrelevantes Plugin deaktivieren. Danach eine frische Sitzung starten, drei normale Aufgaben wiederholen und alles zurücksetzen, was das Ergebnis verändert. So entsteht bis Freitag eine belastbare Richtlinie zum Einsparen von Kontext – nicht bloß eine ordentlichere Konfiguration, die den Agent unbemerkt schlechter gemacht hat.

Wie lässt sich der Kontextverbrauch von Claude Code senken?

Mit /skill-doctor ungenutzte Listing-Kosten aufspüren, mit /context die Gesamtverteilung prüfen, irrelevante Skills verbergen, seltene Workflows nur manuell aufrufbar machen, lange Referenzen in unterstützende Dateien verschieben und zwischen fachfremden Aufgaben /clear verwenden.

Wie lassen sich die Kosten von Claude Code minimieren?

Zuerst den wiederkehrenden Kontext reduzieren, danach Modellwahl, lange Sitzungen, Thinking-Einstellungen, umfangreiche Tool-Ausgaben und ungenutzte MCP-Server angehen. /skill-doctor deckt lediglich den Skill-Anteil dieser Rechnung ab.

Sind Claude Code Skills kostenlos?

Anthropics Skill-Dokumentation nennt keine separate Gebühr für eine lokale SKILL.md. Name und Beschreibung können jedoch in jedem Turn Kontext verbrauchen; nach dem Aufruf belegt auch der vollständige Inhalt Kontext. API-Nutzer zahlen nach Tokenverbrauch, während Nutzer eines Abonnements ihr enthaltenes Kontingent ausschöpfen.

Wie lässt sich der Kontext in Claude Code komprimieren?

/compact bewahrt den Zusammenhang einer langen Aufgabe; /clear eignet sich beim Wechsel zu einer unabhängigen Aufgabe. Aufgerufene Skill-Inhalte können nach der Komprimierung erneut angehängt werden – begrenzt auf 5,000 Tokens pro Skill und insgesamt 25,000 Tokens.

Sollte der Kontext in Claude Code geleert werden?

Ja, beim Wechsel zu einer unabhängigen Aufgabe. Für einen Test zur Skill-Bereinigung ist eine frische Sitzung wichtig, weil ein bereits in die alte Unterhaltung geladener Skill-Inhalt die Wirkung seiner Deaktivierung verdecken kann.

Für Engineering-Teams, die einen messbaren Governance-Workflow für Skills benötigen, sind KI-Produktionssysteme der nächste Schritt.