Den Skill auffindbar und eindeutig beschreiben
Legen Sie einen Skill-Ordner mit SKILL.md an. Name und Beschreibung stehen in den Metadaten; die Beschreibung nennt ausdrücklich passende und unpassende Aufgaben. Codex lädt zunächst diese Einordnung und bei Auswahl die Anleitung. Projektbezogene Skills können unter .agents/skills versioniert werden. Prüfen Sie die tatsächlich erkannte Skill-Liste, bevor Sie von einer erfolgreichen Einrichtung ausgehen.
Beispiel: eine wiederholbare Bugfix-Abnahme
Der Skill beschreibt: Fehler reproduzieren, kleinste passende Änderung erstellen, betroffene Tests ausführen und den Diff erklären. Er nennt erforderliche Eingaben und den Umgang mit nicht reproduzierbaren Fehlern. Ein Testfall enthält eine bekannte Regression, ein anderer unzureichende Angaben. Bewertet werden Auftragsklarheit und Ergebnisqualität; identische Texte in jedem Lauf sind kein notwendiges Qualitätsmerkmal.
Anweisungen, Skripte und Rechte getrennt pflegen
Prüfen Sie optionale Skripte wie anderen ausführbaren Code. Zugangsdaten werden nicht in das Paket geschrieben. Eine Formulierung wie „nur lesen“ ist eine Arbeitsregel; technische Rechte müssen dazu passen. Versionieren Sie Skill, Vorlagen und Testfälle gemeinsam. Nach Änderungen prüfen Sie sowohl den passenden Auslöser als auch einen Auftrag, bei dem der Skill nicht verwendet werden soll.
Entscheidungsmatrix
| Prüfpunkt | Weiter, wenn | Stoppen, wenn |
|---|---|---|
| Auftrag und Eingaben | Dokumentiert: Trigger, Eingaben, Regeln, Werkzeuge, Tests und erwartetes Ergebnis. | Scope, Daten oder Verantwortung sind noch ungeklärt. |
| Wiederholbarkeit | Ein geeigneter Testauftrag löst den Skill nachvollziehbar aus und liefert das erwartete Ergebnis einschließlich relevanter Tests. Ein ungeeigneter Auftrag zeigt, dass der beschriebene Scope begrenzt bleibt. | Es liegt nur eine unbewertete Demo ohne Abnahmenachweis vor. |
| Pflege und Grenzen | Owner, Freigabe, Ersatzweg und nächster Prüftermin sind festgelegt. | Zu vermeiden: Skills ohne Versionskontrolle und reale Testfälle. Ein Skill ohne Versionsstand oder reale Testfälle lässt sich weder zuverlässig ändern noch als geprüfter Teamablauf übernehmen. |
Nachvollziehbar bleiben
Primärquellen
- OpenAI: Build skillsQuellenstand:
- Agent Skills: SpecificationQuellenstand:
