Codex CLI 0.166.0 wurde am 29. Oktober 2026 veröffentlicht. Wenn Sie Ihre lokalen Skills anlässlich dieser Version prüfen, kontrollieren Sie zuerst den Dateikopf. Die folgenden Metadatenregeln stammen aus der aktuellen Agent-Skills-Spezifikation; sie werden hier nicht als Änderung dieser CLI-Version dargestellt.
Ein Ordner mit Anweisungen ist noch kein gültiger Agent-Skill. Der offene Standard verlangt SKILL.md mit YAML-Kopf und anschließendem Markdown. Ein Formatfehler kann verhindern, dass das Programm den beabsichtigten Ablauf erkennt.
Zuerst den kleinen Kopf validieren
Für den Ordner weekly-brief enthält ein minimaler Kopf name: weekly-brief und eine nicht leere Beschreibung von Aufgabe und Einsatz. Der Name muss dem Ordner entsprechen und die Namensregeln erfüllen. Anfangs- und Endtrenner des Kopfes stehen jeweils auf einer eigenen Zeile.
Lassen Sie zunächst den Text prüfen, bevor Sie den Ablauf umschreiben. Suchen Sie fehlende Felder, versehentliche Einrückungen und übernommene Beispielnamen. Nutzen Sie die dokumentierte Validierung oder Aktualisierung. Eine Datei auf der Festplatte belegt noch keine Erkennung.
Ohne private Aufgabe kontrollieren
Aktualisieren Sie die Skill-Liste und lesen Sie Beschreibung und Pfad. Bei erneutem Fehler bewahren Sie die Meldung auf und ändern Sie nur die erkannte Ursache. Verwenden Sie keine privaten Dokumente als Installationstest. Metadatenprüfung und spätere Ergebnisqualität sind getrennte Schritte.
Diese Prüfung betrifft lokale Skills in Codex CLI und anderen Programmen, die den Standard unterstützen. Plugin-Verteilung und Kontozugriff sind getrennte Fragen. Codex erkennt Änderungen automatisch; erscheinen sie nicht, empfiehlt die aktuelle Anleitung einen Neustart von Codex. Ändern Sie keine Berechtigungen, um einen YAML-Fehler zu beheben.