tradermonty/skill-designer

Was macht skill-designer?

Übersicht

Generiere einen umfassenden Claude-CLI-Prompt aus einer strukturierten Skill-Ideenbeschreibung. Der Prompt weist Claude an, ein vollständiges Skill-Verzeichnis gemäß den Repository-Konventionen zu erstellen: SKILL.md mit YAML-Frontmatter, Referenzdokumente, Helfer-Skripte und Testgrundstruktur.

Wann verwenden

• Die Skill-Auto-Generierungs-Pipeline wählt eine Idee aus dem Backlog aus und benötigt einen Design-Prompt für claude -p
• Ein Entwickler möchte einen neuen Skill aus einer JSON-Ideenbeschreibung bootstrappen
• Die Qualitätsprüfung generierter Skills erfordert Kenntnis des Bewertungsschemas

Voraussetzungen

• Python 3.9+
• Keine externen API-Schlüssel erforderlich
• Referenzdateien müssen unter references/ vorhanden sein

Arbeitsablauf

Schritt 1: Ideenbeschreibung vorbereiten

Akzeptiere eine JSON-Datei (--idea-json) mit:

• title: Lesbarer Ideenname
• description: Was der Skill tut
• category: Skill-Kategorie (z. B. trading-analysis, developer-tooling)

Akzeptiere einen normalisierten Skill-Namen (--skill-name), der als Verzeichnisname und als name:-Feld im YAML-Frontmatter verwendet wird.

Schritt 2: Design-Prompt erstellen

Führe den Prompt-Builder aus:

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

Das Skript:

1. Lädt die Ideen-JSON
2. Liest alle drei Referenzdateien (Strukturleitfaden, Qualitätscheckliste, Vorlage)
3. Listet vorhandene Skills auf (bis zu 20), um Duplikate zu vermeiden
4. Gibt einen vollständigen Prompt auf der Standardausgabe aus

Schritt 3: Prompt an Claude CLI übergeben

Die aufrufende Pipeline leitet den Prompt an claude -p weiter:

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

Schritt 4: Ausgabe validieren

Nachdem Claude den Skill erstellt hat, überprüfe:

• skills/<skill-name>/SKILL.md existiert mit korrektem Frontmatter
• Die Verzeichnisstruktur folgt den Konventionen
• Die Bewertung mit dual-axis-skill-reviewer erreicht den Schwellenwert

Ausgabeformat

Das Skript gibt einen Klartext-Prompt auf der Standardausgabe aus. Exit-Code 0 bei Erfolg, 1 falls erforderliche Referenzdateien fehlen.

Ressourcen

• references/skill-structure-guide.md -- Verzeichnisstruktur, SKILL.md-Format, Namenskonventionen
• references/quality-checklist.md -- Dual-Axis-Reviewer-Checkliste mit 5 Kategorien (100 Punkte)
• references/skill-template.md -- SKILL.md-Vorlage mit YAML-Frontmatter und Standardabschnitten
• scripts/build_design_prompt.py -- Prompt-Builder-Skript (CLI-Schnittstelle)