Codex vs Claude Code Skills: Einrichtung, Einstellungen und wie man Skills in beiden Tools gemeinsam nutzt

Name

Soren Atelier

Updated on 10.2.2026

"Skills" entwickeln sich rasch zur portablen Wiederverwendungseinheit fuer KI-Coding-Agents. Ein Skill ist ein Ordner, der Anweisungen, optionale Skripte und Referenzdateien buendelt, sodass ein Agent sie zuverlaessig erkennen und anwenden kann. Wenn Sie mit mehr als einem KI-Coding-Tool arbeiten, haben Sie die Reibungsverluste durch separate Konfigurationen fuer jedes Tool wahrscheinlich bereits gespuert.

OpenAI Codex und Anthropic Claude Code unterstuetzen beide Skills und bauen beide auf dem Agent Skills Open Standard auf. Codex gibt ausdruecklich an, dass seine Skills auf diesem Standard basieren und "Progressive Disclosure" nutzen, um den Kontext effizient zu verwalten. Claude Code folgt ebenfalls dem Agent Skills Standard und fuegt eigene Erweiterungen wie Aufrufsteuerung, Subagents und dynamische Kontexteinspeisung hinzu.

Diese gemeinsame Basis macht einen "einmal schreiben, in beiden Tools nutzen"-Workflow moeglich — vorausgesetzt, Sie achten darauf, wo Skills abgelegt werden, wie sich die Einstellungen unterscheiden und welche Frontmatter-Felder portabel sind. Diese Anleitung schluesselt jeden praktischen Unterschied auf und zeigt Ihnen, wie Sie einen einzelnen Skill in beiden Agents gemeinsam nutzen koennen.

Schnellvergleich: Codex Skills vs Claude Code Skills

Gedankenmodell: Gleiche SKILL.md, unterschiedliche Oekosysteme

Beide Tools teilen die Kernidee: ein Verzeichnis mit einer SKILL.md-Datei, die YAML-Frontmatter (name, description) und Markdown-Anweisungen enthaelt. Der Agent liest die Metadaten, um zu entscheiden, wann der Skill verwendet werden soll, und laedt die vollstaendigen Anweisungen erst bei Aktivierung. Die Unterschiede liegen in den Erkennungspfaden, Konfigurationsformaten und erweiterten Funktionen.

Was Codex unter "Skills" versteht

Codex-Skills sind Verzeichnisse mit einer erforderlichen SKILL.md und optionalen scripts/, references/, assets/ sowie einer optionalen agents/openai.yaml fuer UI-Metadaten und Abhaengigkeiten (wie MCP-Server).

Codex laedt zuerst die Skill-Metadaten und erst dann die vollstaendigen Anweisungen, wenn der Skill tatsaechlich verwendet wird. Dies wird als Progressive Disclosure bezeichnet — es haelt die Kontextfenster schlank, indem nur das eingespeist wird, was der Agent tatsaechlich benoetigt.

Was Claude Code unter "Skills" versteht

Claude Code Skills basieren ebenfalls auf SKILL.md und fungieren als wiederverwendbare Slash-Befehle. Claude kann sie automatisch aufrufen, wenn sie relevant sind, oder Sie koennen sie direkt ueber /skill-name ausfuehren.

Claude Code hat benutzerdefinierte Slash-Befehle explizit mit Skills zusammengefuehrt:

• .claude/commands/review.md und .claude/skills/review/SKILL.md erzeugen beide /review
• Skills fuegen unterstuetzende Dateien, Aufrufsteuerung und automatisches Laden bei Relevanz hinzu

So erstellen und installieren Sie einen Skill in Codex

1. Verzeichnisstruktur des Skills

Mindestens benoetigt ein Codex-Skill:

my-skill/
  SKILL.md

Ein vollstaendig ausgestatteter Skill kann enthalten:

my-skill/
  SKILL.md
  scripts/
    run-check.sh
  references/
    CHECKLIST.md
  assets/
    diagram.png
  agents/
    openai.yaml

Die SKILL.md muss name und description im YAML-Frontmatter enthalten.

2. Wo Codex Skills erkennt

Codex durchsucht mehrere Speicherorte mit definierter Prioritaet:

Codex unterstuetzt ausdruecklich symbolisch verlinkte Skill-Ordner und folgt dem Symlink-Ziel beim Scannen.

3. Integrierte Skill-Werkzeuge verwenden

Codex bietet zwei integrierte Hilfsprogramme:

• $skill-creator — erstellt ein neues Skill-Verzeichnis mit der korrekten Struktur
• $skill-installer — laedt und installiert Skills aus externen Quellen

4. Skills in den Einstellungen aktivieren oder deaktivieren

Codex kann einen Skill deaktivieren, ohne ihn zu loeschen, indem Eintraege unter [[skills.config]] in der TOML-Konfiguration hinzugefuegt werden:

# ~/.codex/config.toml
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Starten Sie Codex nach Aenderungen an der Konfiguration neu.

5. Codex-Konfigurationsformat

Die Codex-Konfiguration liegt in TOML-Dateien mit einer klaren Prioritaetsreihenfolge:

CLI-Flags > Profile > Projektkonfiguration (.codex/config.toml) > Benutzerkonfiguration (~/.codex/config.toml) > Systemkonfiguration > Standardwerte

Skills koennen ueber diese Einstellungen gesteuert werden, und diese Einstellungen koennen pro Projekt festgelegt werden.

So erstellen und installieren Sie einen Skill in Claude Code

1. Verzeichnisstruktur des Skills

Claude Code Skills sind Verzeichnisse mit SKILL.md als Einstiegspunkt. Zusaetzliche Dateien sind optional:

my-skill/
  SKILL.md
  template.md
  examples/
    sample.md
  scripts/
    validate.sh

Referenzieren Sie unterstuetzende Dateien in Ihrer SKILL.md, damit Claude weiss, was sie enthalten und wann sie geladen werden sollen.

2. Wo Claude Code Skills erkennt

Claude Code hat mehrere Bereiche mit Prioritaet:

Claude Code unterstuetzt auch verschachtelte Erkennung in Monorepos: Wenn Sie packages/frontend/... bearbeiten, wird auch packages/frontend/.claude/skills/ durchsucht.

3. Das SKILL.md-Format: YAML + Markdown

Claude Code Skills bestehen aus zwei Teilen — YAML-Frontmatter und Markdown-Anweisungen:

---
name: explain-code
description: Explains code with visual diagrams and analogies.
---
 
When explaining code:
1) Start with an analogy
2) Draw an ASCII diagram
3) Walk step-by-step
4) Highlight a gotcha

Der name wird zum /slash-command, und description hilft Claude bei der Entscheidung, wann der Skill automatisch geladen werden soll.

4. Erweiterte Skill-Funktionen von Claude Code

Claude Code erweitert den Standard um Funktionen, die in Codex nicht verfuegbar sind:

Dies ist der groesste praktische Unterschied: Claude Skills koennen sich wie Mini-Workflows mit Vorverarbeitung und Subagents verhalten, waehrend Codex Skills den Schwerpunkt auf das Buendeln von Anweisungen, Ressourcen und Skripten mit progressivem Laden legen.

5. Claude Code Konfigurationsformat

Claude Code Einstellungen sind im JSON-Format, nach Bereichen (verwaltet/Benutzer/Projekt/lokal) gegliedert, und ueber /config in der interaktiven REPL bearbeitbar:

• Benutzer: ~/.claude/settings.json
• Projekt: .claude/settings.json
• Lokale Ueberschreibungen: .claude/settings.local.json

Wesentliche Unterschiede: Detaillierter Vergleich

Erkennungspfade

Codex:        .agents/skills/  →  $HOME/.agents/skills/  →  /etc/codex/skills/
Claude Code:  .claude/skills/  →  ~/.claude/skills/       →  enterprise managed

Dies ist der Hauptgrund, warum das Teilen von Skills Symlinks oder ein gemeinsames Repository erfordert.

Konfigurationsformate

Aktivierungs-UX

• Codex: /skills-Liste und $-Erwaehnung in CLI/IDE; implizite Auswahl ueber description
• Claude Code: /skill-name-Aufruf; automatisches Laden basierend auf description

Tool-spezifische Erweiterungen

• Codex: Optionale agents/openai.yaml fuer UI-Metadaten und Abhaengigkeitsdeklarationen (z. B. MCP-Server)
• Claude Code: Frontmatter-Felder wie disable-model-invocation, context: fork, Befehlsvorverarbeitung (!`…`), Argumentuebergabe

Der gemeinsame Kern: Agent Skills Open Standard

Wenn Sie moechten, dass ein Skill sowohl in Codex als auch in Claude Code funktioniert, verankern Sie ihn in der Agent Skills Spezifikation. Folgendes erfordert die Spezifikation:

Erforderliche Frontmatter-Felder

Codex erfordert beide Felder. Claude Code ist nachsichtiger (es kann name standardmaessig vom Verzeichnis ableiten), aber fuer agentuebergreifende Wiederverwendung sollten Sie beide als erforderlich behandeln.

Dateireferenzen

Die Spezifikation empfiehlt, Dateien mit relativen Pfaden vom Skill-Stammverzeichnis zu referenzieren:

See [the reference guide](references/REFERENCE.md) for details.
 
Run the extraction script:
scripts/extract.py

Halten Sie Referenzen auf einer Ebene, um komplexe verschachtelte Ketten zu vermeiden.

So teilen Sie einen Skill mit Symlinks zwischen beiden Agents

Das sauberste Muster zur Verwendung eines Skills in beiden Tools:

1. Pflegen Sie ein einzelnes kanonisches Skills-Repository oder einen Ordner
2. Verlinken Sie diese Skill-Ordner per Symlink in den jeweiligen Erkennungspfad des Agents

Schritt-fuer-Schritt-Einrichtung

Angenommen, Sie speichern gemeinsam genutzte Skills in ~/shared-agent-skills/:

~/shared-agent-skills/
  code-review/
    SKILL.md
    references/
      REVIEW_CHECKLIST.md
  test-writer/
    SKILL.md
    scripts/
      run-tests.sh

Fuer Codex in ein Projekt verlinken:

mkdir -p .agents/skills
ln -s ~/shared-agent-skills/code-review .agents/skills/code-review
ln -s ~/shared-agent-skills/test-writer .agents/skills/test-writer

Fuer Claude Code in dasselbe Projekt verlinken:

mkdir -p .claude/skills
ln -s ~/shared-agent-skills/code-review .claude/skills/code-review
ln -s ~/shared-agent-skills/test-writer .claude/skills/test-writer

Oder auf Benutzerebene fuer alle Projekte verlinken:

# Codex (Benutzerbereich)
ln -s ~/shared-agent-skills/code-review $HOME/.agents/skills/code-review
 
# Claude Code (Benutzerbereich)
ln -s ~/shared-agent-skills/code-review ~/.claude/skills/code-review

Hinweise zur Symlink-Kompatibilitaet

Wenn die /skills-Auflistung von Claude Code Ihren symbolisch verlinkten Skill nicht anzeigt, koennen Sie ihn dennoch direkt ueber den Namen aufrufen.

Eine portable SKILL.md-Vorlage

Hier ist eine spezifikationskonforme Vorlage, die in beiden Agents funktioniert:

---
name: code-review
description: >
  Perform a structured code review for correctness, security,
  performance, and readability. Use when asked to review a
  diff, PR, or when preparing changes for merge.
license: MIT
compatibility: >
  Intended for coding agents (Codex, Claude Code) in Git repos.
  Requires read access to the repo.
metadata:
  owner: platform-team
  version: "1.0.0"
---
 
# Code Review Skill
 
## Inputs
- A diff, PR link, or list of changed files.
- The relevant module/service context.
 
## Process
1. Identify the goal of the change and expected behavior.
2. Review for correctness (edge cases, error handling).
3. Review for security (authz/authn, injection risks, secrets).
4. Review for performance (N+1 queries, hot paths, allocations).
5. Review for maintainability (naming, structure, tests).
6. Summarize findings with:
   - Must-fix items
   - Suggestions
   - Positive notes
 
## Reference checklist
See [our checklist](references/REVIEW_CHECKLIST.md) for the full list.

Codex-spezifische Metadaten hinzufuegen (optional)

Fuegen Sie agents/openai.yaml fuer Codex-UI-Metadaten und Abhaengigkeiten hinzu. Andere Tools ignorieren diese Datei:

# agents/openai.yaml
display_name: "Code Review"
icon: "🔍"
dependencies:
  mcp_servers:
    - github

Claude Code-spezifische Funktionen hinzufuegen (optional)

Fuer reine Claude-Workflows koennen Sie erweitertes Frontmatter in einem separaten Claude-bezogenen Skill oder in einer .claude/-spezifischen Ueberschreibung hinzufuegen:

---
name: code-review
description: Structured code review with security focus.
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash(git diff*)
context: fork
---

Best Practices fuer agentuebergreifende Skills

1. Portablen Inhalt im gemeinsamen Ordner belassen

Bleiben Sie bei den Feldern der Agent Skills Spezifikation (name, description) und verwenden Sie references/ mit relativen Links fuer umfangreiche Dokumente und Checklisten. So stellen Sie sicher, dass beide Agents den Skill korrekt parsen und nutzen koennen.

2. Tool-spezifische Erweiterungen isolieren

• Fuer Claude Code: context: fork, !-Befehlsvorverarbeitung und allowed-tools sind leistungsstark, aber Claude-spezifisch
• Fuer Codex: agents/openai.yaml ist Codex-spezifisch, aber sauber in einer eigenen Datei separiert

Keines der Tools hat Probleme mit unbekannten Feldern — sie werden einfach ignoriert. Aus Gruenden der Uebersichtlichkeit ist es jedoch besser, tool-spezifische Funktionen in tool-spezifischen Dateien oder Ueberschreibungen zu halten.

3. Ein gemeinsames Git-Repository fuer Skills verwenden

shared-agent-skills/          # Git-Repository
├── code-review/
│   ├── SKILL.md
│   └── references/
├── test-writer/
│   ├── SKILL.md
│   └── scripts/
├── setup-links.sh            # Symlink-Installationsskript
└── README.md

Ein einfaches setup-links.sh kann die Symlink-Erstellung automatisieren:

#!/bin/bash
SKILL_DIR="$(cd "$(dirname "$0")" && pwd)"
 
# In Codex-Benutzerbereich verlinken
mkdir -p "$HOME/.agents/skills"
for skill in "$SKILL_DIR"/*/; do
  name=$(basename "$skill")
  [ "$name" = "scripts" ] && continue
  ln -sfn "$skill" "$HOME/.agents/skills/$name"
done
 
# In Claude Code-Benutzerbereich verlinken
mkdir -p "$HOME/.claude/skills"
for skill in "$SKILL_DIR"/*/; do
  name=$(basename "$skill")
  [ "$name" = "scripts" ] && continue
  ln -sfn "$skill" "$HOME/.claude/skills/$name"
done
 
echo "Skills linked for both Codex and Claude Code."

4. Versionieren Sie Ihre Skills

Fuegen Sie ein version-Feld in den Metadaten hinzu und taggen Sie Releases in Ihrem gemeinsamen Skills-Repository. Wenn ein Skill sein Verhalten aendert, hilft das Erhoehen der Version Teams nachzuvollziehen, was sich wann geaendert hat.

Wenn Sie KI-Coding-Agents wie Codex oder Claude Code fuer Datenanalyse-Workflows verwenden, kann PyGWalker (opens in a new tab) Ihre DataFrames in interaktive Visualisierungen verwandeln — und Sie koennen einen Skill erstellen, der PyGWalker in das Toolkit Ihres Agents integriert, fuer Datenexploration auf Abruf.

FAQ

Was ist der Agent Skills Open Standard?

Der Agent Skills Open Standard ist eine Spezifikation, die definiert, wie KI-Coding-Agents wiederverwendbare Skill-Pakete erkennen und nutzen. Er legt ein gemeinsames Format fest — ein Verzeichnis mit einer SKILL.md-Datei, die YAML-Frontmatter und Markdown-Anweisungen enthaelt — sodass Skills zwischen verschiedenen Agent-Tools portabel sind.

Kann ich dieselbe SKILL.md in Codex und Claude Code verwenden?

Ja. Beide Agents bauen auf dem Agent Skills Standard auf und erkennen SKILL.md-Dateien mit name- und description-Frontmatter. Die Hauptanforderung besteht darin, den Skill in den Erkennungspfad jedes Agents zu legen (.agents/skills/ fuer Codex, .claude/skills/ fuer Claude Code), was Sie mit Symlinks von einem einzigen kanonischen Speicherort aus tun koennen.

Was sind die Hauptunterschiede zwischen Codex Skills und Claude Code Skills?

Die Kernunterschiede liegen in den Erkennungspfaden (.agents/skills/ vs .claude/skills/), den Konfigurationsformaten (TOML vs JSON) und den Erweiterungsfunktionen. Claude Code fuegt Subagent-Context-Forking, Shell-Befehlsvorverarbeitung und Werkzeugzugriffskontrollen hinzu. Codex fuegt agents/openai.yaml fuer UI-Metadaten und MCP-Server-Abhaengigkeiten hinzu. Das grundlegende SKILL.md-Format ist in beiden kompatibel.

Funktionieren Symlinks zum Teilen von Skills zwischen Agents?

Codex unterstuetzt ausdruecklich symbolisch verlinkte Skill-Ordner und folgt den Zielen. Claude Code funktioniert ebenfalls mit Symlinks fuer den Aufruf, obwohl der /skills-Auflistungsbefehl symbolisch verlinkte Skills in einigen Versionen moeglicherweise nicht erkennt. Sie koennen symbolisch verlinkte Skills dennoch ueber den Namen aufrufen, auch wenn sie nicht in der Liste erscheinen.

Welche Frontmatter-Felder sind fuer portable Skills erforderlich?

Die Agent Skills Spezifikation erfordert name (muss mit dem uebergeordneten Verzeichnis uebereinstimmen, Kleinbuchstaben mit Bindestrichen, 1-64 Zeichen) und description (hilft Agents bei der Entscheidung, wann der Skill verwendet werden soll). Beide, Codex und Claude Code, unterstuetzen diese Felder. Zusaetzliche Felder wie license, compatibility und metadata sind optional, aber empfohlen.

Wo sollte ich Skills fuer benutzerweiten Zugriff ablegen?

Fuer Codex legen Sie Skills in $HOME/.agents/skills/ ab. Fuer Claude Code verwenden Sie ~/.claude/skills/. Beide Speicherorte machen Skills in allen Projekten verfuegbar, ohne dass eine Einrichtung pro Repository erforderlich ist.

Fazit

Codex und Claude Code Skills teilen mehr Gemeinsamkeiten, als ihre unterschiedlichen Oekosysteme vermuten lassen. Beide bauen auf dem Agent Skills Open Standard auf, beide verwenden SKILL.md als Einstiegspunkt, und beide unterstuetzen progressives Laden basierend auf Skill-Beschreibungen. Die praktischen Unterschiede — Erkennungspfade, Konfigurationsformate und Erweiterungsfunktionen — sind real, aber handhabbar.

Die beste Strategie besteht darin, eine einzige Quelle der Wahrheit fuer Ihre Skills zu pflegen, die spezifikationserforderlichen Felder name und description fuer den portablen Kern zu verwenden und Symlinks einzusetzen, damit jeder Agent denselben Skill-Ordner sieht. Halten Sie tool-spezifische Erweiterungen (Claudes Subagent-Forking, Codex' YAML-Metadaten) in den jeweiligen Erweiterungsdateien. So erhalten Sie Portabilitaet, ohne auf die erweiterten Funktionen eines der beiden Tools verzichten zu muessen.