SKILL.md-Portabilität: Ein technischer Vergleich von Claude Code und Codex CLI

Das SKILL.md-Format ist ein einfacher, leistungsfähiger Standard zur Erweiterung der Fähigkeiten von Coding-Agenten. Sowohl Claude Code von Anthropic als auch Codex CLI von OpenAI unterstützen es. Dies führt zu einer entscheidenden Frage für Entwickler: Läuft dieselbe SKILL.md-Datei auf beiden? Die einfache Antwort lautet: Ja, die Datei selbst ist portabel. Die nützliche Antwort ist komplexer und hat weniger mit dem Dateiformat zu tun als mit der Ausführungsumgebung, die jeder Agent bereitstellt.

Bei SkillProof installieren und führen wir Claude Code-Skills für reale Aufgaben aus, um zu sehen, ob sie bestehen. Wir veröffentlichen die Ergebnisse, einschließlich der Fehlschläge. Von 2090 in einer Claude Code-Umgebung getesteten Skills haben 1291 bestanden (62 %), 697 funktionierten erst nach einer Konfiguration, die in der Beschreibung genau dargelegt werden muss, und 102 erhielten das Urteil „nicht bestanden“: Einige liefen und verschlechterten das Ergebnis im Vergleich zur Nichtverwendung des Skills, andere konnten aufgrund eines fehlenden CLI, einer veralteten Abhängigkeit oder eines abstürzenden Beispiels gar nicht ausgeführt werden. Wir haben noch nie einen Skill auf Codex CLI ausgeführt. Unser gesamter Datensatz basiert auf der Ausführung mit Claude Code.

Unser Testkorpus enthält jedoch einen einzigartigen, unidirektionalen Satz an Evidenz. Dieser Artikel untersucht die technischen Unterschiede in der Handhabung von SKILL.md durch die beiden Agenten und was unsere reinen Claude-Daten über die Portabilität von Codex zu Claude aussagen.

Die Gemeinsamkeit: Das SKILL.md-Format

Bevor die Agenten verglichen werden, ist es wichtig zu verstehen, was eine SKILL.md-Datei ist. Es ist eine Textdatei, die Anweisungen für den Agenten mit Metadaten kombiniert. Die Struktur ist einfach:

1. YAML-Frontmatter: Ein durch --- begrenzter Block am Anfang der Datei enthält Schlüssel-Wert-Paare. name und description sind fundamental. Der Agent verwendet die Beschreibung, um zu entscheiden, wann der Skill aufgerufen werden soll. Ein optionaler allowed-tools-Schlüssel benennt Werkzeuge, für die der Skill eine Vorabgenehmigung wünscht, damit er nicht mitten in der Ausführung nachfragen muss. Es ist ein Komfortfeld, keine Sandbox: Es entzieht dem Modell keine Werkzeuge. Eine detaillierte Aufschlüsselung finden Sie in unserer Frontmatter-Referenz.
2. Markdown-Body: Unter dem Frontmatter befindet sich der Anweisungssatz für den Agenten, geschrieben in einfachem Markdown. Dieser teilt dem Modell mit, wie die Aufgabe Schritt für Schritt zu erledigen ist.
3. Gebündelte Dateien: Ein Skill kann andere Dateien enthalten, wie Skripte oder Referenzdaten, die mit ihm gebündelt werden.

Entscheidend ist, dass SKILL.md keine Funktionssignaturen oder Argument-Schemata enthält. Es ist ein Anweisungsformat in natürlicher Sprache, kein strukturiertes Manifest für Funktionsaufrufe. Das ist die Domäne von MCP, einem separaten und eigenständigen Protokoll. Für eine tiefere Auseinandersetzung damit, siehe unseren Vergleich von Claude Skills vs. MCP.

Da SKILL.md nur strukturierter Text ist, kann jeder konforme Parser ihn lesen. Sowohl Claude Code als auch Codex CLI können dieselbe Datei ohne Änderung laden. Der Unterschied liegt in dem, was danach geschieht.

Laden und Ausführung: Zwei verschiedene Umgebungen

Obwohl die Datei dieselbe ist, ist der Kontext, in dem sie ausgeführt wird, nicht derselbe. Die Architektur des Agenten, die Standardeinstellungen und die verfügbaren Werkzeuge definieren die Ausführungsumgebung. Hier zeigen sich die praktischen Unterschiede zwischen Claude Code und OpenAI Codex.

Claude Code

In unserer Arbeit testen wir ausschließlich mit Claude Code. Skills werden für persönliche Skills aus ~/.claude/skills und für projektbezogene Skills aus .claude/skills innerhalb eines Projekts geladen. Wenn man dem Agenten eine Aufgabe gibt, gleicht er die Eingabeaufforderung mit dem description-Feld aller verfügbaren Skills ab. Man kann einen Skill auch direkt über einen Slash-Befehl namentlich aufrufen.

Ein kritisches Verhalten, das wir dokumentiert haben, ist sein Fehlerfall. Wenn das YAML-Frontmatter in einer SKILL.md-Datei fehlerhaft ist – ein falsch platzierter Tabulator, ein fehlendes Anführungszeichen – erzeugt Claude Code keinen Validierungsfehler. Der Skill wird für den Agenten einfach unsichtbar. Er wird nicht aufgelistet und niemals ausgelöst. Dieser stille Fehler kann schwer zu debuggen sein, ein Thema, das wir in unserem Beitrag darüber behandeln, was zu tun ist, wenn ein Skill nicht ausgelöst wird.

Unsere Methodik beinhaltet die Ausführung jedes Skills für eine reale Aufgabe. Die Ergebnisse unserer 2090 Tests zeigen, dass ein ‚pass‘ nicht garantiert ist. Die 697 Skills, die mit ‚setup‘ bewertet wurden, erforderten eine nicht-triviale Konfiguration, die wir dokumentieren mussten. Die 102 als ‚fails‘ bewerteten Skills konnten entweder aufgrund fehlender Abhängigkeiten gar nicht ausgeführt werden oder lieferten ein schlechteres Ergebnis als bei Nichtverwendung eines Skills.

Codex CLI

Codex CLI ist ein Open-Source-Terminal-Coding-Agent von OpenAI. Es ist kein API-Wrapper, sondern ein eigenständiges Werkzeug, das eine Codebasis liest, Bearbeitungen über mehrere Dateien hinweg durchführt und Befehle in Ihrer lokalen Umgebung ausführt. Die Unterstützung für SKILL.md wurde im Dezember 2025 eingeführt, zunächst als experimentelles Feature.

Die Erkennungspfade haben sich seit der Einführung geändert, was wissenswert ist, wenn man einer älteren Anleitung folgt. Die aktuelle OpenAI-Dokumentation listet .agents/skills im Arbeitsverzeichnis und dessen übergeordneten Verzeichnissen für projektbezogene Skills, $HOME/.agents/skills für persönliche und /etc/codex/skills für systemweite Skills auf. Der ursprüngliche Speicherort ~/.codex/skills ist der, den man immer noch in den meisten READMEs von Drittanbieter-Skills findet. Ein Skill kann explizit durch Eingabe von $ und Auswahl aus der Liste aufgerufen oder implizit ausgelöst werden, wenn eine Aufgabe seiner Beschreibung entspricht.

Die primäre Konfigurationsdatei ist ~/.codex/config.toml, und der Kernanweisungssatz kann über eine Datei namens AGENTS.md angepasst werden. Dies bietet einen anderen Ansatzpunkt für Anpassungen im Vergleich zum Skill-zentrierten Modell von Claude Code.

Unterstützt Codex also SKILL.md? Ja, nativ. Das Dateiformat ist ein vollwertiger Bestandteil. Die Abweichung ergibt sich aus der Umgebung, die es für die Ausführung dieser Datei bereitstellt.

Unidirektionale Portabilität: Was unsere Daten zeigen

Dies ist der Kern des Problems. Wir haben niemals einen Skill auf Codex CLI getestet. Wir können keine Erfolgsquote für Codex oder einen direkten Vergleich auf Basis unserer eigenen Testdaten liefern. Etwas anderes zu behaupten, käme der Erfindung eines Datensatzes gleich.

Was wir jedoch bieten können, ist ein ehrlicher Blick auf ein spezifisches Muster in unseren Claude Code-Testergebnissen. Von den 2090 von uns getesteten Skills erwähnen oder setzen laut unseren Notizen 47 eine Codex-Umgebung voraus. Diese Skills wurden für Codex geschrieben, aber wir haben sie in einer Claude Code-Umgebung ausgeführt. Dies gibt uns eine einzigartige, unidirektionale Sicht auf die Portabilität.

Die Ergebnisse für diese 47 Skills sind:

• Bestanden: 11
• Setup: 34
• Fehlgeschlagen: 2

Dies erzählt eine klare Geschichte: Eine für Codex geschriebene SKILL.md-Datei erfordert mit hoher Wahrscheinlichkeit eine manuelle Einrichtung, um auf Claude Code zu laufen. Das liegt nicht daran, dass die Datei ungültig ist, sondern daran, dass die Anweisungen des Skills auf Werkzeugen oder Pfaden basieren, die in der neuen Umgebung nicht existieren.

Betrachten wir spezifische Beispiele aus unserem Katalog:

• Generate 2D Map (Urteil: Setup): Das Upstream-README des Skills gibt explizit an, dass er für Codex/Grok ist und listet Installationspfade wie ~/.codex/skills und ~/.grok/skills auf, nicht den in seiner Beschreibung angegebenen Pfad ~/.claude/skills. Seine primäre Pipeline benötigt ein integriertes Paar von Werkzeugen zur Bilderzeugung und -anzeige, das Claude Code nicht besitzt. Wir haben ihn auf dem einzigen Branch getestet, der keine Bilder benötigt – dem Erstellen einer orthogonalen Tiled-Karte als JSON – und der Skill entsprach exakt dem Basismodell: byte-identische Tile-Arrays, identische Spawn- und Exit-Metadaten. Die Datei wurde geladen; der Teil, für den sich die Installation gelohnt hätte, lief nicht.

• Generate 2D Sprite (Urteil: Setup): Dieser Skill hat dasselbe Problem. Er hat eine harte Abhängigkeit von Bilderzeugungsfähigkeiten, die mit Codex und Grok, aber nicht mit Claude Code ausgeliefert werden. Er kann ein Sprite-Sheet planen, aber nicht den letzten Schritt der Erstellung der Grafik ausführen.

• Ablation Planner (Urteil: Setup): Der Hauptmechanismus dieses Skills besteht darin, Designarbeiten an ein spezifisches Codex-Werkzeug zu übergeben. Bei der Ausführung in unserer Claude Code-Umgebung war dieses Werkzeug nicht verfügbar. Der Schritt musste manuell durchgeführt werden, was der Definition eines ‚Setup‘-Urteils entspricht.

Diese Beispiele zeigen, dass die SKILL.md-Datei portabel ist, die Logik des Skills jedoch möglicherweise nicht. Die Anweisungen sind nur Text; wenn sie den Agenten anweisen, ein nicht vorhandenes Werkzeug zu verwenden, wird der Prozess anhalten.

Umgekehrt haben 11 dieser auf Codex ausgerichteten Skills problemlos bestanden. Skills wie Better Codex und PinMe Share haben unsere Tests auf Claude Code bestanden. Beide beziehen ihren Wert aus Text und nicht aus herstellerspezifischen Werkzeugen. Better Codex ist ein reines Prompt-Verhaltens-Overlay ohne externe Dateien oder Skripte und hat das Basismodell bei einer Config-Parser-Aufgabe übertroffen, bei der die Baseline stillschweigend bei Werten mit einem Gleichheitszeichen versagte. PinMe Share wird aus einer einzigen gültigen SKILL.md ohne lose Referenzen installiert, und sein Vorteil liegt in der exakten Kenntnis eines gewöhnlichen npm-CLI: Es gab den kanonischen Upload-Befehl und die erforderlichen Authentifizierungsschritte aus, während das Basismodell den Befehl riet und die Anmeldung übersprang. Das ist die Form eines portablen Skills. Er benötigt ein Werkzeug, das man installieren kann, nicht ein eingebautes, das mit dem Agenten eines bestimmten Anbieters geliefert wird.

Hauptunterschiede im Überblick

Ein direkter Vergleich verdeutlicht die Kompromisse bei der Entscheidung zwischen Codex CLI und Claude Code für das Programmieren mit Skills.

Merkmal	Claude Code	Codex CLI
Skill-Pfad	~/.claude/skills (persönlich), .claude/skills (Projekt)	$HOME/.agents/skills (persönlich), .agents/skills (Repo), /etc/codex/skills (systemweit)
Konfiguration	settings.json, plus CLAUDE.md für Anweisungen	~/.codex/config.toml, plus AGENTS.md für Anweisungen
Sandboxing	Opt-in; Umgebungsvariablen werden von der übergeordneten Shell geerbt	Standardmäßig im Workspace-Schreibmodus aktiviert, Netzwerk aus, sofern nicht aktiviert
Fehlerhafte SKILL.md	Lädt stillschweigend nicht	(Verhalten von uns nicht getestet)

Der Sandbox-Kompromiss

Der bedeutendste Unterschied in den Ausführungsumgebungen ist das standardmäßige Sandboxing-Verhalten.

Codex CLI arbeitet laut seiner Dokumentation mit einer strengeren standardmäßigen Sicherheitsposition. In seinem Workspace-Schreibmodus ist der Netzwerkzugriff deaktiviert, es sei denn, man aktiviert ihn explizit in config.toml. Dateisystemschreibvorgänge sind auf den aktuellen Workspace beschränkt, und die Genehmigungsrichtlinie des Agenten fragt standardmäßig vor einer Aktion nach Bestätigung. Dies ist ein ‚Default-Deny‘-Modell.

Claude Code verfolgt, wie von Anthropic dokumentiert, einen anderen Ansatz. Sandboxing ist etwas, das man einschaltet, anstatt es auszuschalten, und selbst wenn es aktiviert ist, erbt die Shell standardmäßig die Umgebung des übergeordneten Prozesses. Das bedeutet, wenn Anmeldeinformationen wie AWS_ACCESS_KEY_ID in Ihrer Terminalsitzung exportiert sind, kann ein von Claude Code aufgerufener Skill diese potenziell lesen. Dadurch funktionieren Skills, die mit externen Diensten oder lokalen Anmeldeinformationen kommunizieren, sofort, und die Verantwortung für die Verwaltung dieses Risikos liegt bei Ihnen.

Keiner der beiden Ansätze ist von Natur aus besser; es ist ein Kompromiss. Das Modell von Codex priorisiert standardmäßig die Sicherheit, was potenziell mehr Konfiguration erfordert, um einen netzwerkfähigen Skill zum Laufen zu bringen. Das Modell von Claude Code priorisiert die sofortige Funktionalität, was potenziell mehr von der Host-Umgebung preisgibt. Ein Skill, der curl für einen API-Aufruf verwendet, funktioniert möglicherweise einfach mit Claude Code, wird aber standardmäßig von Codex CLI blockiert.

Die Entscheidungsregel: Beurteilen Sie die Umgebung, nicht die Datei

Also, Claude Code vs. Codex CLI: Welches sollte man für Skills verwenden?

Unsere Daten liefern eine ehrliche, wenn auch unvollständige, Antwort. Das SKILL.md-Dateiformat selbst ist nicht der entscheidende Faktor. Dieselbe Datei wird auf beiden Plattformen geladen. Die eigentliche Entscheidung hängt von der Ausführungsumgebung und den Abhängigkeiten der Skills ab, die Sie ausführen möchten.

1. Prüfen Sie Werkzeugabhängigkeiten: Basiert der Skill auf eingebauten, agentenspezifischen Werkzeugen (wie der Bilderzeugung in Generate 2D Map)? Wenn ja, wird er nicht portabel sein.
2. Prüfen Sie universelle CLI-Abhängigkeiten: Verwendet der Skill nur allgegenwärtige Kommandozeilen-Werkzeuge? Er hat eine hohe Chance, portabel zu sein, wie die 11 auf Codex ausgerichteten Skills zeigen, die in unserer Claude Code-Umgebung bestanden haben.
3. Berücksichtigen Sie Ihre Sandbox-Präferenz: Bevorzugen Sie ein System, das standardmäßig gesperrt ist und explizite Berechtigungen erfordert (Codex CLI)? Oder bevorzugen Sie eines, das von Haus aus reibungsloser funktioniert, aber Ihren gesamten Umgebungskontext erbt (Claude Code)?

Wir können keinen universellen Gewinner ausrufen, da wir nicht auf beiden Plattformen getestet haben. Die Wahl hängt von Ihren spezifischen Anforderungen und Ihrer Sicherheitsposition ab. Was wir mit Sicherheit sagen können, ist, dass die Annahme, ein Skill funktioniere nur, weil die SKILL.md-Datei kompatibel ist, ein Fehler ist. Die Umgebung ist alles.

Weiterführende Lektüre: AGENTS.md vs Claude Skills behandelt die andere Hälfte der werkzeugübergreifenden Frage – die Anweisungsdatei, die jeder Agent liest, bevor ein Skill geladen wird. Und wenn Sie sich zwischen Terminal-Agenten aus anderen Gründen als Skills entscheiden, arbeitet Claude Code vs Cursor diesen Kompromiss durch.

Bei SkillProof liegt unser Wert darin, diese Unsicherheit für das Claude Code-Ökosystem zu beseitigen. Wir übernehmen das Testen, damit Sie es nicht tun müssen. Jedes ‚pass‘-Urteil in unserem Katalog repräsentiert einen Skill, den wir für reale Arbeit auf Claude Code installiert und ausgeführt haben. Als kuratierten Ausgangspunkt sammeln unsere rollenbasierten Skill-Pakete jeweils zehn getestete Skills für eine Berufsfunktion – Entwickler, Sicherheitsüberprüfung, Marketing, Design und vier weitere – für 10 $ pro Paket, wobei das Urteil jedes Skills vorab angegeben wird.