| name | skill-naming-optimizer |
| description | Validiert und optimiert Skill-Namen und Beschreibungen nach Best Practices. Verwenden bei Skill-Erstellung, Skill-Überarbeitung, Frontmatter-Optimierung, Verbesserung der Skill-Auslösung. |
Skill Naming Optimizer
Dieser Skill optimiert name und description im YAML-Frontmatter von Skills. Er ergänzt den skill-creator und sollte bei Step 4 (Edit the Skill) angewendet werden.
Wann verwenden
- Bei Erstellung eines neuen Skills (nach
init_skill.py)
- Bei Überarbeitung bestehender Skills
- Wenn ein Skill nicht korrekt ausgelöst wird
Name-Optimierung
Regeln (strikt)
| Regel | Gültig | Ungültig |
|---|
| Kebab-Case | csv-analyzer | csvAnalyzer, CSV_Analyzer |
| Nur a-z, 0-9, Bindestriche | api-v2-client | api_client, API-Client |
| Max. 64 Zeichen | data-processor | (zu lang) |
| Muss Verzeichnisnamen entsprechen | /skills/my-skill/ → name: my-skill | |
Validierung
python /home/ubuntu/skills/skill-naming-optimizer/scripts/validate_name.py "skill-name"
Description-Optimierung
Die description ist der primäre Auslösemechanismus. Manus entscheidet anhand der Beschreibung, ob ein Skill verwendet wird – der Body wird erst danach geladen.
Struktur (empfohlen)
[Was der Skill tut]. [Wann verwenden]: [Anwendungsfall 1], [Anwendungsfall 2], [Anwendungsfall 3].
Checkliste
- Was - Beschreibt die Hauptfunktion klar?
- Wann - Sind konkrete Anwendungsfälle genannt?
- Länge - Unter 100 Wörter (immer im Kontext)?
- Trigger-Wörter - Enthält Begriffe, die Benutzer verwenden würden?
Beispiele
Gut:
description: Analysiert CSV-Dateien in einem sequentiellen Workflow. Verwenden für: CSV-Datenanalyse, statistische Auswertungen, Datenvisualisierung.
Besser:
description: Document creation and editing with tracked changes. Use for: creating .docx files, modifying content, working with tracked changes, redlining documents.
Schlecht:
description: Ein Skill für CSV-Dateien.
(Zu vage, keine Anwendungsfälle, wird nicht zuverlässig ausgelöst)
Optimierungsscript
Analysiere und optimiere eine bestehende Beschreibung:
python /home/ubuntu/skills/skill-naming-optimizer/scripts/optimize_description.py "/path/to/SKILL.md"
Integration mit skill-creator
Bei Verwendung des skill-creator diesen Skill in Step 4 (Edit the Skill) anwenden:
- Nach Erstellung des Frontmatters →
validate_name.py ausführen
- Nach Schreiben der Beschreibung → Checkliste prüfen
- Optional:
optimize_description.py für Verbesserungsvorschläge
Schnellreferenz
---
name: kebab-case-max-64-zeichen
description: [Hauptfunktion]. [Wann verwenden]: [Anwendungsfall 1], [Anwendungsfall 2], [Anwendungsfall 3].
---
