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.
Skills und migrierte Plugins wie Betriebsanweisungen pflegen
Prüfen Sie optionale Skripte wie anderen ausführbaren Code und halten Sie Zugangsdaten aus dem Paket heraus. Ein Plugin kann Skills und Werkzeuge zusammenbringen; es erweitert keine Berechtigung allein durch seine Anleitung. Bei der angekündigten Custom-GPT-Migration werden bisherige Anweisungen und Referenzdateien anders verpackt, während benutzerdefinierte Aktionen nicht automatisch mitwandern. Prüfen Sie deshalb Quellen, aufgerufene Werkzeuge und erwartete Ergebnisse vor einer Übernahme. Versionieren Sie Arbeitsanweisung und Testfälle gemeinsam und testen Sie auch einen unpassenden Auslöser.
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:
- OpenAI: Custom GPT transition FAQQuellenstand:
