CommunitySchreiben & Editierengithub.com

zakelfassi/skills-driven-development

KI-Agenten lernen durch Handeln – und merken sich, wie sie es gemacht haben. Eine Methodik, mit der KI-Agenten wiederverwendbare Fähigkeiten entwickeln, weiterentwickeln und teilen.

Was ist skills-driven-development?

SkillForge ist eine Methodik und ein Framework für KI-Agenten (wie Claude Code, Cursor oder Codex), um aus wiederholten Handlungsmustern formelle, spezifikationskonforme Skills zu erstellen. Es adressiert das Problem, dass Agenten oft die gleichen Aufgaben mehrfach lösen, aber kein Gedächtnis für die Lösung haben. Die Methode umfasst sechs Schritte: Muster erkennen, Skill benennen, Verzeichnis anlegen, SKILL.md schreiben, optionale Skripte hinzufügen und den Skill in einer Registry registrieren. Sie betont klare Namenskonventionen (kebab-case, verb-led), strukturierte Eingaben und Schritte, Edge Cases und eine Qualitätskontrolle vor dem Commit. Skills werden lokal im Projekt unter `skills/<skill-name>/` abgelegt und über eine Registry (`.skills-registry.md` oder `.skills-registry.json`) nachverfolgt. Der Ansatz fördert die kontinuierliche Verbesserung von Skills durch Update-Mechanismen und verhindert Bloat durch Längenbegrenzung (max. 200 Zeilen) und Auslagerung in Referenzdateien.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add zakelfassi/skills-driven-development

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 description ist 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:

  1. Füge den neuen Randfall oder Schritt zur vorhandenen SKILL.md hinzu
  2. Wenn der Skill zu lang wird (>200 Zeilen), teile ihn auf
  3. Aktualisiere last-used und erhöhe usage-count in der Registry

Qualitäts-Checkliste

Bevor du einen neuen Skill committest:

  • name ist kebab-case, ≤64 Zeichen
  • description enthä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

Verwandte Skills