Eine Skill, die nie läuft, hat selten ein Syntaxproblem. Sie lädt, steht in der Liste und wird nie gewählt — weil die Beschreibung nicht sagt, wann sie zutrifft, oder es in Wörtern sagt, die niemand verwendet. Dieses Versagen ist bauartbedingt still: kein Fehler, keine Warnung, kein Hinweis, dass etwas nicht stimmt. Dieser Linter liest die Datei wie der Loader, meldet alles Fehlerhafte und wendet sich dann fast ganz der Beschreibung zu: ob sie einen Auslöser nennt, ob sie lang genug ist und ob sie damit beginnt, zu wiederholen, dass sie eine Skill ist. Felder, die der Loader ignoriert, werden ebenfalls benannt, denn ein Tippfehler im Schlüssel sieht genauso aus wie eine funktionierende Datei.
Funktionen
Liest das Frontmatter mit einem echten YAML-Parser und zeigt, wo es scheitert
Benennt Felder, die der Loader nicht liest — so sieht ein Tippfehler im Schlüssel aus
Prüft die Beschreibung auf Auslöser und Länge
Meldet die Zeichenzahl der Beschreibung gegen das Limit
Prüft, ob die Anweisungen die Länge überschreiten, unter der sie nicht helfen
Bewertung, bei der Fehler schwerer wiegen als Vorschläge
Datei ablegen oder einfügen
Ein absichtlich kaputtes Beispiel, um zu sehen, was gefunden wird
So verwendest du Skill-Linter
Legen Sie eine SKILL.md ab oder fügen Sie den Inhalt ein
Lesen Sie die Befunde, das Schlimmste zuerst
Korrigieren Sie die Beschreibung, wenn sie auftaucht — sie ist entscheidend
Prüfen Sie erneut, bis die Bewertung sauber ist
Beispiel
Eingabe
description: Helps with PDFs
Ausgabe
Warning: says what the skill is, but not when to use it
Der häufigste Grund, warum eine Skill nie gewählt wird.
Häufige Fehler & Fehlerbehebung
Es sagt, es gebe kein Frontmatter, aber da ist eindeutig eines. — Die drei Bindestriche müssen die allererste Zeile sein: keine Leerzeile, kein Kommentar, nichts darüber.
Das YAML scheitert an einer langen Beschreibung. — Eine Beschreibung mit Doppelpunkt plus Leerzeichen muss zitiert werden, sonst liest YAML sie als weiteren Schlüssel.
Es beanstandet ein Feld, das ich absichtlich nutze. — Unbekannte Felder erscheinen als Hinweise, nicht als Fehler. Der Loader ignoriert sie; der Hinweis existiert, weil ein falsch geschriebener Schlüssel identisch aussieht.
Die Bewertung bleibt niedrig, ohne dass Fehler gelistet sind. — Warnungen kosten ebenfalls Punkte. Das übliche Paar ist eine Beschreibung ohne Auslöser und zu kurze Anweisungen.
Häufig gestellte Fragen
Warum lädt meine Skill, wird aber nie gewählt?
Die Beschreibung wird mit der Aufgabe abgeglichen; beschreibt sie nur das Thema — „arbeitet mit Tabellen“ — gibt es nichts, womit eine Anfrage zusammenpassen könnte. Ein Zusatz, der die Situation, die Dateitypen oder die Wörter eines Menschen nennt, genügt meist.
Was zählt als Auslöserformulierung?
Alles, was den Moment benennt: „Verwenden, wenn der Nutzer … verlangt“, „Immer wenn eine Migrationsdatei sich ändert…“, „Für Aufgaben rund um…“. Der Linter sucht diese Form und warnt, wenn keine da ist.
Ist eine lange Beschreibung schlecht?
An sich nicht — das Limit ist großzügig und die Zahl wird angezeigt. Schädlich ist eine lange Beschreibung, die trotzdem nie sagt, wann die Skill zu verwenden ist; diese Kombination ist erstaunlich häufig.
Kann ich eine fremde Skill prüfen?
Das ist eine gute Verwendung. Eine Skill von anderswo abzulegen zeigt sofort, ob ihre Beschreibung mit Ihren eigenen konkurriert und ob sie unerwartete Werkzeuge deklariert.
Garantiert ein sauberes Ergebnis, dass die Skill funktioniert?
Nein. Es heißt, dass die Datei lädt und die Beschreibung die abgeglichene Form hat. Ob die Anweisungen gut sind, ist ein Urteil, das kein Linter fällt.
Verwandte Tools
Skill-Builder — Schreiben Sie eine SKILL.md, deren Frontmatter beim Tippen geprüft wird.
Subagent-Builder — Erstellen Sie die Definitionsdatei eines Subagenten samt Tools und Modell.
System-Prompt-Linter — Finden Sie Widersprüche, tote Anweisungen und ungefüllte Platzhalter.
Tool-Schema-Prüfer — Fügen Sie eine Definition ein und sehen Sie, warum sie abgelehnt wird.
Projektanweisungen — Verfassen Sie eine CLAUDE.md, die ihren Platz in jeder Sitzung verdient.
Slash-Befehl-Builder — Bauen Sie einen eigenen Befehl, mit Argumenten und einer Tool-Liste.
Weitere KI & Agenten-Tools
Skill-Builder — Schreiben Sie eine SKILL.md, deren Frontmatter beim Tippen geprüft wird.
Subagent-Builder — Erstellen Sie die Definitionsdatei eines Subagenten samt Tools und Modell.
Slash-Befehl-Builder — Bauen Sie einen eigenen Befehl, mit Argumenten und einer Tool-Liste.
Projektanweisungen — Verfassen Sie eine CLAUDE.md, die ihren Platz in jeder Sitzung verdient.
Plugin-Manifest — Erzeugen Sie eine plugin.json und sehen Sie den erwarteten Ordneraufbau.
Hooks-Builder — Bauen Sie settings.json-Hooks und finden Sie Matcher, die nie auslösen.