Fähigkeiten validieren
Validiert alle Fähigkeiten in skills/ anhand der agentskills.io-Spezifikation und der Claude Code-Best Practices.
Validierungs-Checkliste
Für jedes Fähigkeitsverzeichnis prüfen:
Spezifikationseinhaltung (agentskills.io)
| Prüfung | Regel |
|---|---|
name-Format | 1-64 Zeichen, Kleinbuchstaben alphanumerisch + Bindestriche, keine führenden/abschließenden/aufeinanderfolgenden Bindestriche |
name stimmt mit Verzeichnis überein | Verzeichnisname muss gleich dem name-Feld sein |
description-Länge | 1-1024 Zeichen, nicht leer |
| Optionale Felder gültig | license, metadata, compatibility falls vorhanden |
Best Practices (Claude Code)
| Prüfung | Regel |
|---|---|
| Beschreibungsformat | Dritte Person, beschreibt was + wann zu verwenden |
| Textlänge | Unter 500 Zeilen |
| Laden ist eine Ebene tief | SKILL.md ist der einzige Einstiegspunkt für progressive Offenlegung: Jede referenzierte Datei muss von SKILL.md aus erreichbar sein. Referenzen dürfen sich gegenseitig verlinken (siehe Hinweis unten). |
| Links sind Markdown | [Text](https://raw.githubusercontent.com/callstackincubator/agent-skills/main/pfad) verwenden, nicht bloße Dateinamen |
| Keine Redundanz | Beschreibung nicht im Textkörper wiederholen |
| Prägnant | Nur Kontext hinzufügen, den Claude nicht bereits hat |
Eine Ebene tief vs. Querverlinkung. Die Regel der einen Ebene Tiefe zielt auf progressive Offenlegungsketten ab – eine Referenz, die nur durch das vorherige Laden einer anderen Referenz entdeckt werden kann (
SKILL.md→a.md→b.md, wobeib.mdnicht vonSKILL.mdaus verlinkt ist). Das ist ein Fehler: Der Lader sieht den Inhalt nicht.Sie verbietet Navigations-Querverweise nicht. Gemäß AGENTS.md enden Referenzdateien mit einer Fußzeile „Verwandte Fähigkeiten“, die auf Geschwisterreferenzen verlinkt – das ist erforderlich. Ein Querverweis ist in Ordnung, solange beide Endpunkte auch direkt von
SKILL.mdaus erreichbar sind. Nur eine Referenz, die ausschließlich über eine andere Referenz erreichbar ist, ist zu beanstanden.
Ausführung
-
Alle Fähigkeitsverzeichnisse finden:
fd -t d -d 1 . skills/ -
Für jede Fähigkeit die
SKILL.mdlesen und anhand der obigen Regeln prüfen -
Probleme in diesem Format melden:
## Validierungsergebnisse ### skills/beispiel-faehigkeit - [BESTANDEN] name-Format gültig - [FEHLGESCHLAGEN] name „beispiel“ stimmt nicht mit Verzeichnis „beispiel-faehigkeit“ überein - [BESTANDEN] Beschreibungslänge OK (156 Zeichen)