Gentleman-Programming/gentle-ai-skill-improver

Aktivierungsvertrag

Verwende diesen Skill beim Auditieren, Umstrukturieren, Normieren oder Verbessern bestehender SKILL.md-Dateien. Verwende gentle-ai-skill-creator beim Erstellen eines brandneuen Skills aus einem wiederverwendbaren Muster.

Harte Regeln

• Lies zuerst docs/skill-style-guide.md und behandle es als verbindlichen Stilvertrag.
• Behandle SKILL.md als Quelle der Wahrheit; bewahre die Absicht des Autors, kritische Regeln, Aktivierungssemantik und Ausgabeanforderungen.
• Verwende .atl/skill-registry.md als Index für Skillnamen, Auslöser, Geltungsbereiche und genaue Pfade, sofern verfügbar.
• Standardmäßig nur auditieren. Ändere Dateien nur, wenn der Benutzer explizit Verbesserungen anwenden möchte.
• Lösche nie sinnvolle Inhalte stillschweigend; verschiebe lange Erklärungen, Beispiele, Vorlagen oder Schemata in lokale Verzeichnisse references/ oder assets/.
• Erfinde keine Auslöser, Richtlinien oder Domänenregeln. Markiere mehrdeutige Fälle zur menschlichen Überprüfung.

Entscheidungsgates

Situation	Aktion
Fehlendes oder ungültiges Frontmatter	Korrigiere name, einzeilige description in Anführungszeichen, license und metadata
Skill liest sich wie Tutorial-Dokumentation	Konvertiere zu Laufzeitanweisungen und verschiebe Hintergrundwissen nach references/
Körper überschreitet Budget	Behalte Regeln, verschiebe Beispiele/Hintergrund in unterstützende Dateien
Verzweigungslogik in Prosa versteckt	Konvertiere in eine kompakte Entscheidungstabelle
Regeln widersprechen sich oder Absicht ist unklar	Melde das Problem; schreibe diese Regel nicht automatisch um

Ausführungsschritte

1. Lies docs/skill-style-guide.md.
2. Lies .atl/skill-registry.md; verwende die aufgelisteten Pfade zur Auswahl von Skills. Falls nicht vorhanden, durchsuche bekannte Skill-Verzeichnisse nach */SKILL.md.
3. Für jeden ausgewählten Skill: auditiere Metadaten, Auslöserklarheit, Abschnittsreihenfolge, Körperbudget, Umsetzbarkeit, Entscheidungsgates, Ausgabevertrag und lokale Referenzen.
4. Gib einen nach Skill gruppierten Auditbericht mit Schweregrad und genauen vorgeschlagenen Änderungen zurück.
5. Im Anwendungsmodus: bearbeite nur sichere Themen, bewahre Inhalte, erstelle bei Bedarf unterstützende Dateien, aktualisiere dann oder fordere /skill-registry:refresh an.

Ausgabevertrag

Gib zurück:

• Auditiere Skills und verwendete Pfade.
• Gefundene Probleme, gruppiert nach Schweregrad.
• Geänderte Dateien, falls der Anwendungsmodus angefordert wurde.
• Empfehlung zur Registry-Aktualisierung, wenn sich Skill-Metadaten oder -Pfade geändert haben.
• Mehrdeutigkeiten, die eine menschliche Überprüfung erfordern.

Referenzen

• docs/skill-style-guide.md — normativer LLM-first-Skill-Stil-Leitfaden.
• skills/skill-registry/SKILL.md — Vertrag zur Aktualisierung und Indizierung der Registry.