6 Muster, die Claude Code Skill-Dateien tatsächlich aktivieren

Ein Entwickler auf r/ClaudeAI testete über drei Monate hinweg mehr als 2.300 Community- und selbst erstellte Skill-Dateien, um herauszufinden, warum die meisten Claude Code Skills nie aktiviert werden. Die wichtigste Erkenntnis: Viele Skills liegen in ~/.claude/skills/ und werden nie ausgelöst, weil Benutzer sie einfach ablegen, ohne die Aktivierungsmuster zu befolgen, die Claude tatsächlich verwendet. Hier sind die sechs Muster, die bestimmen, ob ein Skill geladen wird.

Muster 1: Spezifische Auslösesprache in der Beschreibung

Claude liest das YAML-Feld description:, um zu entscheiden, wann ein Skill relevant ist. Eine allgemeine Beschreibung wie „Hilft bei Datenbank-Dingen“ wird nie ausgelöst. Eine spezifische wie „Verwenden Sie dies, wenn Sie Datenbankverbindungspools konfigurieren, Poolgrößen wählen oder Verbindungserschöpfung debuggen“ löst zuverlässig aus. Die Beschreibung ist das Auffindbarkeits-Primitiv des Skills, kein Beiwerk.

Muster 2: Eine Fähigkeit pro Datei, eng abgegrenzt

Ein Skill, der „alles rund um SQL“ abdeckt, verliert gegen drei separate Skills für das Schreiben von Migrationen, das Beheben von Injection-Problemen und das Erklären von Abfrageplänen. Claudes Matching verwendet die Kosinus-Ähnlichkeit zwischen der Eingabeaufforderung des Benutzers und der Beschreibung jedes Skills. Verwässerte Beschreibungen matchen schwach; spezifische gewinnen.

Muster 3: Konventionen im Frontmatter sind wichtig

Die Felder, die Claude tatsächlich verwendet: name, description, category, difficulty. Optional, aber nützlich: tags. Benutzerdefinierte Schlüssel werden geparst, beeinflussen aber nicht die Aktivierung. Das Hinzufügen von zufälligen Metadaten verlangsamt nichts, hilft aber auch nicht.

Muster 4: Listen für „Wann nicht verwenden“

Explizite „Verwenden Sie diesen Skill nicht, wenn…“-Listen machen die Aktivierung genauer, nicht weniger genau. Sie geben Claude negative Beispiele, die den Auslösebereich eingrenzen. Diesen Abschnitt wegzulassen, ist der häufigste Fehler in Community-Skills.

Muster 5: Codebeispiele, die tatsächlich kompilieren

Wenn ein Skill einen Codeblock mit fehlerhafter Syntax enthält, tendiert Claude dazu, den Skill bei der Aktivierung zu meiden, weil das Beispiel der Beschreibung widerspricht. Lassen Sie jeden Codeblock vor dem Speichern durch einen Syntaxprüfer laufen.

Muster 6: Überprüfungsschritte im Hauptteil

Skills, die Abschnitte wie „Führen Sie dies aus und überprüfen Sie danach…“ enthalten, erzielen eine höhere Aktivierungszuverlässigkeit bei Aufgaben, die während der Ausführung stehen. Der Überprüfungsanker hilft Claude zu entscheiden: „Ja, das ist der Skill, der zu dem passt, was der Benutzer versucht.“

Beispiel-Skills, die alle 6 Muster erfüllen

• smart-commit — Muster 1 + 6
• connection-pool-setup — Muster 2
• sql-injection-fix — Muster 4
• redis-lua — Muster 5
• error-handling-audit — Muster 6
• api-documentation — Muster 1
• angular-rxjs — Muster 2
• trpc-router — Muster 5
• dockerfile-generator — Muster 4
• infrastructure-as-code — Muster 3
• custom-slash-commands — Muster 1
• placebo-detector — Muster 4

Diese Skills sind unter clskillshub.com/browse als Referenz verfügbar, oder Sie können mit den sechs Mustern Ihre eigenen schreiben.