Gentle-Programming/gentle-ai-skill-creator

Aktivierungsvertrag

Verwende diesen Skill, wenn du einen wiederverwendbaren KI-Skill für Pi oder eine andere Agenten-Laufzeitumgebung erstellst oder aktualisierst.

Erstelle einen Skill, wenn:

• ein Arbeitsablauf oder eine Konvention über mehrere Sitzungen hinweg wiederverwendet wird;
• generisches Agentenverhalten projektspezifische Einschränkungen benötigt;
• ein Entscheidungsbaum dem Agenten hilft, sicher zu wählen;
• Beispiele, Vorlagen oder Referenzen die zukünftige Ausführung zuverlässiger machen würden.

Erstelle keinen Skill für eine einmalige Aufgabe, generische Dokumentation oder Regeln, die in Code/Tests gehören.

Harte Regeln

• Folge docs/skill-style-guide.md als normative Quelle für Skill-Struktur und -Stil.
• Ein Skill ist ein LLM-Laufzeitvertrag, keine menschenlesbare Dokumentation.
• Halte SKILL.md prägnant: Ziel 180–450 Tokens, maximal 1000.
• Verwende imperative Anweisungen und konkrete Entscheidungstore; vermeide Tutorials und Hintergrundprosa.
• Die description in den Frontmatter-Daten muss eine physische, YAML-sichere Zeile sein und die Auslösewörter zuerst enthalten.
• Füge keinen Abschnitt Keywords hinzu; setze wesentliche Auslösewörter in die description.
• Lege Vorlagen, Schemas und generierte Beispiele in assets/ ab.
• Lege längere Erläuterungen oder lokale Dokumentationslinks in references/ ab.
• Aktualisiere nach Änderungen an Projektskills die Registrierung mit /skill-registry:refresh, sofern verfügbar.

Entscheidungstore

Bedarf	Aktion
Kleines, wiederverwendbares Verhalten	Nur skills/{skill-name}/SKILL.md erstellen
Vorlagen, Schemas, Testdaten	skills/{skill-name}/assets/ hinzufügen
Längere Erklärung oder Randfälle	skills/{skill-name}/references/ hinzufügen
Vorhandener Skill deckt es ab	Den vorhandenen Skill aktualisieren
Skill beeinflusst Delegationserkennung	Sicherstellen, dass Auslösewörter in description vorkommen

Ausführungsschritte

1. Lies docs/skill-style-guide.md, bevor du Skills erstellst oder aktualisierst.
2. Überprüfe vorhandene Skills und bestätige, dass der neue Skill keinen dupliziert.
3. Wähle einen Kebab-Case-Skillnamen, der dem benutzerseitigen Auslöser entspricht.
4. Erstelle oder aktualisiere diese Struktur:

skills/{skill-name}/
├── SKILL.md
├── assets/       # optional
└── references/   # optional

5. Verwende diese Frontmatter-Form:

---
name: {skill-name}
description: "Trigger: {Phrasen, die Benutzer oder Agenten sagen werden}. {Was dieser Skill tut}."
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---

6. Schreibe die Abschnitte in dieser Reihenfolge: Aktivierungsvertrag, Harte Regeln, Entscheidungstore, Ausführungsschritte, Ausgabevertrag, Referenzen.
7. Wenn es sich um einen verpackten gentle-pi-Skill handelt, füge ihn scripts/verify-package-files.mjs hinzu.
8. Aktualisiere oder dokumentiere den Aktualisierungspfad der Skill-Registrierung.

Ausgabevertrag

Gib zurück:

• Erstellte oder geänderte Dateien.
• Ob ein neuer Skill erstellt oder ein vorhandener aktualisiert wurde.
• Alle hinzugefügten unterstützenden assets/- oder references/-Dateien.
• Ob eine Paketüberprüfung oder eine Aktualisierung der Skill-Registrierung erforderlich ist.

Referenzen

• docs/skill-style-guide.md — normative LLM-zentrierte Skill-Stilrichtlinie.
• skills/skill-registry/SKILL.md — Vertrag zur Aktualisierung und Indizierung der Registrierung.