BWBYB/agent-skills

Persönlicher Skill-Builder

Erstelle kleine, auffindbare Skills, die die Entscheidungen des Agenten für einen bestimmten, wiederholbaren Arbeitsablauf verbessern.

Umfang

Verwende diese Skill für einen neuen Skill oder eine gezielte Änderung an einem bestehenden Skill. Bewahre den vom Benutzer gewünschten Speicherort, die Aufrufrichtlinie und die Autorisierungsgrenzen bei. Erstelle keine Skill nur, um allgemeine Ratschläge zu speichern, die der Agent bereits kennt.

Arbeitsablauf

1. Lege die Aufgabenabgrenzung fest, bevor du Dateien schreibst:

   • Welches wiederholbare Ergebnis liefert die Skill?
   • Welche Anfragen sollen sie aktivieren, und welche ähnlichen Anfragen nicht?
   • Welche Eingaben, Werkzeuge, Nebeneffekte und Abschlussprüfungen sind wichtig?

2. Untersuche eine vorhandene Skill, bevor du sie änderst. Behalte nützliche Ressourcen und Richtlinien bei; initialisiere ein vorhandenes Verzeichnis nicht neu.

3. Wähle die kleinste Struktur:

   • SKILL.md ist erforderlich.
   • Füge references/ nur hinzu, wenn es umfangreiches, bedingtes Material gibt, das Entscheidungen beeinflusst.
   • Füge scripts/ nur für wiederholte oder deterministische Arbeiten hinzu, bei denen die Ausführung die Zuverlässigkeit verbessert.
   • Füge assets/ nur für Dateien hinzu, die in der generierten Ausgabe verwendet werden.

4. Schreibe SKILL.md:

   • Der Frontmatter-name muss in Kleinbuchstaben mit Bindestrichen geschrieben sein, mit dem Verzeichnisnamen übereinstimmen und maximal 64 Zeichen lang sein.
   • Die description muss sowohl angeben, was die Skill tut, als auch, wann sie angewendet wird; schließe eine Abgrenzung ein, wenn sie Fehlleitungen verhindert.
   • Halte den Hauptteil fokussiert auf Ergebnisse, nicht offensichtliche Regeln, Ausführungsreihenfolge, Bestätigungspunkte und Abschlussprüfungen.
   • Setze bedingte Details in eine verlinkte Ressource und gib genau an, wann sie gelesen werden soll.

5. Validiere das Ergebnis mit dem verfügbaren Skill-Validator, wenn die Umgebung einen bereitstellt (suche quick_validate.py unter der installierten skill-creator Skill):

   python3 <skill-creator>/scripts/quick_validate.py /pfad/zum/skill
   

   Falls kein Validator verfügbar ist, führe die entsprechenden Prüfungen der Frontmatter, Namensgebung, Ressourcenverweise, Platzhalter und Skripte manuell durch. Führe hinzugefügte Skripte aus, wenn praktikabel.

Gestaltungsregeln

• Behandle die Beschreibung als Routing-Bedingung, nicht als Funktionskatalog.
• Halte gemeinsame Anweisungen kurz genug für das routinemäßige Laden; kopiere keine vollständige externe Spezifikation in den Einstiegspunkt.
• Bevorzuge expliziten Umfang und beobachtbare Abschlusskriterien gegenüber breiten Verboten oder vagen Qualitätsadjektiven.
• Füge keine README-Dateien, Beispiele, Vorlagen oder Ressourcenverzeichnisse hinzu, ohne einen konkreten Arbeitsablauf, der sie verwendet.
• Behalte vorhandene unterstützte Frontmatter- und agents/openai.yaml-Felder bei, wenn du eine Skill aktualisierst.
• Lasse die automatische Erkennung aktiviert, es sei denn, der Benutzer fordert explizit die nur-explizite Aufrufmethode an.

Referenzen

Lies die Agent Skills-Spezifikation, wenn Unsicherheit bezüglich Portabilität, Frontmatter-Feldern, Namensbeschränkungen oder Ladeverhalten besteht. Behandle jeden benutzerbereitgestellten oder maschinenlokalen Gestaltungsleitfaden als optionale Präferenzquelle: Lies ihn nur, wenn der Benutzer explizit diese Konventionen anfordert oder die Aufgabe davon abhängt, und kopiere seinen vollständigen Inhalt nicht in die Skill. Konsultiere eine installierte skill-creator-Skill für Initialisierungs-, UI-Metadaten- oder Validierungsdetails, anstatt von einem maschinenspezifischen absoluten Pfad abhängig zu sein.