Was macht skill-quality-check?
Qualitätsprüfungswerkzeug für KI-Agent-Fähigkeiten. Prüft jede SKILL.md anhand eines 5-dimensionalen Bewertungsrahmens gemäß den Best Practices von Claude.
Überblick
Dieses Tool analysiert SKILL.md-Dateien, die für KI-Agenten wie Claude Code, Cursor oder Codex entwickelt wurden, und bewertet sie anhand eines 5-dimensionalen Frameworks:
- Klarheit – Wie klar ist die Beschreibung des Skills?
- Vollständigkeit – Fehlen wichtige Abschnitte oder Details?
- Nutzerfreundlichkeit – Wie einfach ist der Skill für Entwickler zu verstehen und zu nutzen?
- Konsistenz – Ist der Skill einheitlich mit Best Practices und Konventionen?
- Effektivität – Wie gut erfüllt der Skill seinen beabsichtigten Zweck?
Verwendung
Führe das Audit mit folgendem Befehl durch:
node audit.js <pfad-zur-skill.md>
Beispiel:
node audit.js ./skills/mein-skill/SKILL.md
Ausgabe
Das Tool gibt eine JSON-Ausgabe mit den Bewertungen und Empfehlungen aus:
{
"gesamtpunktzahl": 78,
"dimensionen": {
"klarheit": 82,
"vollständigkeit": 75,
"nutzerfreundlichkeit": 80,
"konsistenz": 70,
"effektivität": 85
},
"empfehlungen": [
"Füge eine Beispielverwendung hinzu.",
"Erkläre die Umgebungsvariablen detaillierter."
]
}
Bewertungsrahmen
| Dimension | Gewichtung | Beschreibung |
|---|---|---|
| Klarheit | 25% | Verständlichkeit der Beschreibung und Anweisungen |
| Vollständigkeit | 20% | Vorhandensein aller erforderlichen Abschnitte |
| Nutzerfreundlichkeit | 25% | Einfachheit der Implementierung und Fehlervermeidung |
| Konsistenz | 15% | Übereinstimmung mit Best Practices von Claude |
| Effektivität | 15% | Zielgerichtete Funktionalität und erwartete Ergebnisse |
Voraussetzungen
- Node.js 18 oder höher
- Die zu prüfende SKILL.md-Datei muss zugänglich sein
Integration in CI/CD
Füge das Audit als Schritt in deine GitHub Actions oder anderen CI/CD-Pipelines ein:
- name: Skill-Qualitätscheck
run: npx webkong/skill-quality-check ./path/to/SKILL.md
Lizenz
MIT