SkillForge
Erstelle wohlgeformte, spezifikationskonforme Skills aus beobachteten Mustern.
Wann schmieden
✅ Schmiede, wenn:
- Du die gleiche Sequenz 2-3 Mal in einer Sitzung ausgeführt hast
- Eine Projektkonvention nirgendwo dokumentiert ist
- Du ein schwieriges Problem mit einer wiederverwendbaren Lösung gelöst hast
- Dich jemand bittet, einen Skill zu erstellen
❌ Schmiede nicht, wenn:
- Es sich um eine einmalige Aufgabe handelt
- Ein bestehender Skill dies bereits abdeckt (stattdessen aktualisieren)
- Der „Skill“ nur ein einzelner Befehl ist (verwende ein Skriptalias)
Schritte
1. Benenne das Muster
- Welches Problem löst dieser Skill?
- Was löst ihn aus? (sei spezifisch – das Feld
descriptionist die Entdeckungsoberfläche) - Was sind die Eingaben und Ausgaben?
2. Wähle einen Namen
kebab-case, 1-64 Zeichen- Nach Möglichkeit verb-led:
deploy-preview,scaffold-component,triage-bug - Eine Verantwortung pro Skill
3. Erstelle das Skill-Verzeichnis
mkdir -p skills/<skill-name>
4. Schreibe SKILL.md
Verwende dieses Grundgerüst:
---
name: <skill-name>
description: <was es tut>. Verwende, wenn <Auslöser>.
metadata:
forged-by: <agent-id>
forged-from: <session-oder-kontext>
forged-reason: "<warum dies erstellt wurde>"
---
# <Skill-Name>
## Eingaben
- ...
## Schritte
1. ...
2. ...
## Konventionen
- Projektspezifische Muster, die gelten
## Randfälle
- Bekannte Stolperfallen oder Sonderbehandlungen
5. Füge Skripte hinzu (optional)
Wenn der Skill Dateigenerierung oder Automatisierung umfasst:
skills/<skill-name>/
├── SKILL.md
├── scripts/
│ └── run.sh # Ausführbare Automatisierung
└── references/
└── conventions.md # Detaillierte Referenz (hält SKILL.md schlank)
6. Registriere den Skill
Aktualisiere .skills-registry.md im Projektstammverzeichnis (gleiche Ebene wie skills/). Erstelle es, falls es nicht existiert:
| <skill-name> | local | <heute> | 1 | <description> |
Falls das Projekt die maschinenlesbare Registry (.skills-registry.json) verwendet, aktualisiere auch diese – skdd forge handhabt beide Formate automatisch.
Aktualisieren eines bestehenden Skills
Wenn du einen Skill verwendest und auf etwas stößt, das er nicht abdeckt:
- Füge den neuen Randfall oder Schritt zur vorhandenen SKILL.md hinzu
- Wenn der Skill zu lang wird (>200 Zeilen), teile ihn auf
- Aktualisiere
last-usedund erhöheusage-countin der Registry
Qualitäts-Checkliste
Bevor du einen neuen Skill committest:
-
nameist kebab-case, ≤64 Zeichen -
descriptionenthält sowohl WAS er tut als auch WANN er verwendet wird - Schritte sind nummeriert und handlungsorientiert
- Keine fest codierten Pfade, Geheimnisse oder umgebungsspezifischen Werte
- SKILL.md ist unter 200 Zeilen (verschiebe Details nach
references/) - Registriert in
.skills-registry.md