Eine Skill ist ein Ordner mit einer SKILL.md darin: ein kurzer YAML-Kopf und Anweisungen in Markdown. In die Anweisungen fließt die Arbeit, und die Beschreibung entscheidet, ob diese Anweisungen je gelesen werden. Sie wird mit der anstehenden Aufgabe abgeglichen, also bleibt eine Beschreibung, die zwar das Thema nennt, aber nie den Anlass, auf unbestimmte Zeit ungenutzt — ohne Fehlermeldung, die erklärt, warum. Dieser Builder schreibt die Datei und prüft genau dieses Feld am gründlichsten: ob es einen Auslöser benennt, ob es lang genug für eine Zuordnung ist und ob es seine ersten Worte verschwendet. Der Name wird gegen die Ordnerregeln geprüft, die Anweisungen gegen die Länge, unterhalb derer sie selten etwas ändern.
Funktionen
Name gegen die Ordnerregeln geprüft, mit korrigiertem Vorschlag
Beschreibung auf eine Auslöserformulierung geprüft — das, was die Zuordnung auslöst
Warnt, wenn eine Beschreibung zu kurz ist, um Signal zu tragen
Optionale Werkzeugliste, ausgewählt statt getippt
Ein Wert, der blockierende Fehler von Vorschlägen trennt
Der genaue Pfad, an den die Datei gehört
Frontmatter korrekt zitiert: ein Doppelpunkt teilt den Wert nicht
Lädt als SKILL.md herunter, direkt einsetzbar
So verwendest du Skill-Builder
Benennen Sie die Skill klein und mit Bindestrichen
Schreiben Sie eine Beschreibung, die sagt was und wann
Verfassen Sie die Anweisungen als Markdown
Lesen Sie die Befunde und laden Sie die SKILL.md
Beispiel
Eingabe
name: release-notes
Ausgabe
description: Writes release notes from a range of git commits. Use when the user asks for a changelog.
Der Zusatz „Verwenden, wenn…“ macht aus einem Thema einen Auslöser.
Häufige Fehler & Fehlerbehebung
Die Skill wird offenbar nie verwendet. — Fast immer die Beschreibung. Sie muss sagen, wann sie zutrifft — mit den Wörtern, die jemand tatsächlich benutzt: Dateitypen, Aufgabennamen, Formulierungen, die eingetippt würden.
Der Name wird abgelehnt. — Er ist zugleich der Ordnername, also nur Kleinbuchstaben, Ziffern und einfache Bindestriche. Passt Ihrer nicht, wird eine korrigierte Fassung vorgeschlagen.
Meine Beschreibung enthält einen Doppelpunkt und die Datei bricht. — Sollte nicht passieren — Werte werden bei Bedarf zitiert. Wenn Sie die Datei später von Hand bearbeiten, setzen Sie alles mit Doppelpunkt plus Leerzeichen in Anführungszeichen.
Die Skill lädt, ändert aber nichts. — Sehr kurze Anweisungen verschieben selten das Verhalten. Sagen Sie, was entstehen soll, wie zu arbeiten ist und was zu unterlassen ist.
Häufig gestellte Fragen
Was macht eine gute Skill-Beschreibung aus?
Sie beantwortet in ein bis zwei Sätzen zwei Fragen: was die Skill tut und wann sie verwendet werden soll. Die zweite Hälfte wird abgeglichen, also nennen Sie die Dateitypen, die Aufgabe und die Formulierung, die Menschen wählen würden. „Hilft mit Dokumenten“ passt zu nichts Bestimmtem.
Wohin gehört die Datei?
In einen Ordner mit dem Namen der Skill, innerhalb eines Skills-Verzeichnisses. Der Pfad steht unter dem Editor und aktualisiert sich beim Tippen. Ordnername und Namensfeld sollten übereinstimmen.
Soll ich eine Werkzeugliste angeben?
Nur wenn die Skill wirklich weniger Werkzeuge braucht als die Sitzung hat. Leer lassen heißt erben, was verfügbar ist, und das ist meist gewollt; einschränken hält eine fokussierte Skill fokussiert.
Wie lang sollten die Anweisungen sein?
Lang genug, um konkret zu sein, und nicht länger. Ein paar Sätze ändern selten etwas; mehrere Seiten werden überflogen. Abschnitte mit Überschriften überstehen Überarbeitungen besser als ein langer Block.
Wird die Datei anderswo geprüft?
Der Loader nimmt eine Datei mit schwacher Beschreibung anstandslos an — genau das ist das Problem. Nichts sagt Ihnen später, dass die Skill unzuordenbar ist, und deshalb gehört die Prüfung davor.
Verwandte Tools
Skill-Linter — Fügen Sie eine SKILL.md ein und sehen Sie, was ihre Zuordnung verhindert.
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.
System-Prompt-Linter — Finden Sie Widersprüche, tote Anweisungen und ungefüllte Platzhalter.
Weitere KI & Agenten-Tools
Skill-Linter — Fügen Sie eine SKILL.md ein und sehen Sie, was ihre Zuordnung verhindert.
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.