Skills in Claude Code: Funktionen ohne Kontextballast behalten

Skripte, Formatierungsregeln und Vorlagen wachsen schnell an. Wird jede Hilfe zur dauerhaften Anweisung, verbraucht die Sitzung Kontext vor der ersten Aufgabe. Dieser Leitfaden zeigt die Inventarisierung, die Trennung von Dauerregeln und bedarfsabhängigen Abläufen sowie den Test der Erkennung.

Einfluss von Skills auf das Startfenster

Bei on legt Claude Code Name und description eines Skills in den Kontext; bei name-only nur den Namen. user-invocable-only und disable-model-invocation: true verbergen die Beschreibung vor dem Modell, off den Skill. Der vollständige Inhalt von SKILL.md wird erst beim Aufruf geladen und bleibt in dieser Sitzung. Referenzen werden bei Bedarf gelesen, Skripte als Werkzeuge ausgeführt. Details stehen in der offiziellen Skills-Dokumentation.

Unterscheiden Sie Listing-Ankündigung, geladenen Instruktionskörper und Ressourcen oder Skripte auf Abruf. Große Referenzen gehören nicht in description oder globales CLAUDE.md.

Mit dem eigenen BetterToken API-Key können Sie im Dashboard Testaufrufe nach Modell, Zeit, Status, Input, Output und Cache-Token vergleichen. Das bestätigt den API-Ablauf, misst aber nicht den lokalen Skill-Kontext und ersetzt /context nicht. Aktuelle Einstellungen stehen in den BetterToken Docs.

Bei zu vielen Skills: /skill-doctor

Führen Sie /skill-doctor lokal aus. Der Stats-Bericht in /plugin zeigt Kontextkosten und Aufrufhäufigkeit und markiert geladene, aber ungenutzte Skills; eingebaute und Enterprise-Skills sind nicht enthalten. Siehe die Berichtsdokumentation. Ordnen Sie die Liste erst den üblichen Aufgaben zu. Keine Aufrufe bedeuten nicht automatisch, dass ein Skill nutzlos ist: Eine Wiederherstellung wird vielleicht nur alle paar Monate benötigt. Seltene Personal- oder Projekt-Skills können in /skills auf user-invocable-only (user-only) gesetzt werden. Wählen Sie off nur, wenn ein Skill in dieser Umgebung nicht mehr gebraucht wird; verwalten Sie Plugin-Skills über /plugin. Prüfen Sie anschließend in einer frischen Sitzung /context, eine normale Aufgabe und den expliziten Aufruf.

Die Versionshinweise zu v2.1.261 nennen den Befehl; die aktuelle Dokumentation nennt v2.1.252 als Minimum. Prüfen Sie claude --version und Feature Flags. Über Remote Control ist der Bericht nicht verfügbar; nutzen Sie das Terminal auf dem Rechner, auf dem die Sitzung läuft oder die manuelle Inventur.

Vergleichen Sie .claude/skills/ und ~/.claude/skills/ mit /skills in jeder Umgebung. Verschachtelte Skills können erst nach Lesen oder Ändern des Unterordners erscheinen, Plugin-Skills verwenden Namespace statt skillOverrides, und synchronisierte Skills können sich lokal, in Cowork und in der Cloud unterscheiden.

Häufigkeit	Platzierung
Täglich	Kurze Regeln in CLAUDE.md oder Basis-Skill
Aufgabenbezogen	Skill mit enger description
Selten	Explizit aufrufbarer user-only Skill mit Skripten

Behalten Sie seltene Sicherheits-, Wiederherstellungs- und Release-Schritte verfügbar, bis reale Szenarien geprüft sind.

Die passende Durchsetzung wählen

Bedarf	Ort
Wiederkehrende Erinnerung	Kurze Regel in CLAUDE.md
Regeneration nur bei Dokumentationsupdates	Eigener Skill
Schreibversuch vorher ablehnen	PreToolUse-Hook
Ergebnis unabhängig prüfen	Minimal berechtigter Subagent
Externes System lesen	MCP-Verbindung

Instruktionen blockieren keine Schreiboperation. Prüfen Sie bei Hooks Event, Matcher und echte Ablehnung: eine Write-Regel blockiert kein Schreiben per Bash; ein separater Subagent ist nicht automatisch read-only. Siehe Mechanismen und Hooks. Verwandte Beispiele: CLAUDE.md-Regeln, Stop-Hook-Prüfung und MCP oder Befehl.

Ein Stop Hook prüft den Abschluss der Arbeit; er ersetzt PreToolUse vor einem Schreibvorgang nicht. Lassen Sie in CLAUDE.md eine kurze Regel mit einem Verweis auf den Skill, statt die gesamte Prozedur in alle Mechanismen zu kopieren.

Kompakte Einträge und Skripte

description braucht klare Trigger und einen kurzen Zweck:

---
name: db-migrator
description: >-
  Verwenden Sie diesen Skill zum Prüfen und Anwenden von Prisma-Migrationen nach einer Schemaänderung.
---

Legen Sie wiederholbare Validierung in scripts/ ab:

<!-- Innerhalb von SKILL.md -->
```bash
python3 "${CLAUDE_SKILL_DIR}/scripts/validate_schema.py" --strict
```

Deaktivieren Sie keine Sicherheits-, Lint- oder Typprüfungen, um Token zu sparen.

Erkennung in vier Schritten prüfen

1. Prüfen Sie, dass SKILL.md existiert.
2. Prüfen Sie Frontmatter als YAML und eine nichtleere description.
3. Prüfen Sie, dass references/, examples/ und scripts/ vom Skill-Verzeichnis aus auflösbar sind.
4. Führen Sie das Skript mit sicherem Testinput aus und prüfen Sie den erwarteten Exit-Code.

Ein Python-Skript braucht kein Executable-Bit, wenn es mit python3 läuft; test -f ersetzt keine YAML-Prüfung. Prüfen Sie in einer frischen Sitzung /skills auf Name, Quelle und Aufrufmodus, rufen Sie einen seltenen Skill explizit auf und stellen Sie in einer zweiten frischen Sitzung eine passende Anfrage ohne Skill-Namen. Vergleichen Sie danach /skill-doctor, /doctor und /context vor und nach einer einzelnen Änderung; bewerten Sie richtige Trigger ebenso wie Token.