Codex Skills: Agent Skills in OpenAI Codex nutzen

Die Kurzantwort

1Leg den Ordner des Skills in ~/.agents/skills/, um ihn in jedem Repository zu nutzen, oder in das .agents/skills/ eines Repos, um ihn dort zu halten.
2Codex braucht in SKILL.md sowohl name (bis zu 64 Zeichen) als auch description (bis zu 1.024).
3Tipp $ plus den Namen des Skills, um ihn auszuführen, oder /skills, um aus einer Liste zu wählen.
4Lieber fertige? Entdecke Codex Skills, die du mit einem Befehl installierst.

Hier starten:Installieren Wo er sucht Skills vs. AGENTS.md

Bevor du loslegst

Skills funktionieren an drei Orten: in der Codex CLI, der Codex-IDE-Erweiterung und Codex in der ChatGPT-Desktop-App. Für die Installation von Skillry per CLI brauchst du außerdem macOS oder Windows und Node.js 22 oder neuer.

So fügst du Skills zu Codex hinzu

Codex und die Skillry CLI nutzen denselben Standardordner, ~/.agents/skills/, du brauchst also kein zusätzliches Flag. Wähl den Weg, der dir liegt.

Am einfachsten, wenn Codex schon offen ist

1
Öffne den Skill auf Skillry, wähle Installations-Prompt kopieren und im Dialog dann Kopieren.
2
Füg ihn in Codex ein und schick ihn ab. Der Agent liest die Installationsanleitung von Skillry und führt selbst den passenden Befehl aus.
Installations-Prompt
```
Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
```
3
Wenn dein Browser dich bittet, einen Gerätecode zu bestätigen, bestätige ihn.
Das solltest du sehen: Codex, das die installierte Version und den genutzten Ordner unter ~/.agents/skills/ meldet.

Ideal, wenn du die Befehle lieber selbst ausführst

1
Melde dich einmal an. Ein Browserfenster öffnet sich mit einem Gerätecode, den du bestätigst.
Terminal
```
npx --yes skillry-cli@latest login
```
2
Installiere. Du brauchst kein Flag, denn der Standardordner der CLI ist genau der, den Codex liest.
Terminal
```
npx --yes skillry-cli@latest install <slug>
```
Das solltest du sehen: Installed <slug> <version> to ~/.agents/skills/<slug>

Ideal unter Linux oder wenn du die Dateien zuerst lesen willst

Wähle ZIP herunterladen auf der Seite des Skills oder nutze einen Skill-Ordner, den du anderswo bekommen hast. Lies vor der Installation SKILL.md und alles in scripts/, denn der Agent folgt diesen Anweisungen und kann diese Skripte ausführen. Verschieb dann den ganzen Ordner:

Terminal

mkdir -p ~/.agents/skills
mv ~/Downloads/my-skill ~/.agents/skills/

ZIPs entpacken sich oft mit einer zusätzlichen Ebene, etwa my-skill/my-skill/SKILL.md. SKILL.md muss direkt im Ordner des Skills liegen, sonst findet der Agent ihn nicht.

Codex hat für den Katalog von OpenAI auch einen eigenen Installer, $skill-installer. Er legt Skills in ~/.codex/skills/ ab, einem älteren Ordner, den Codex weiterhin liest – Skills aus beiden Installern erscheinen also zusammen.

Prüfen, ob Codex ihn gefunden hat

Tipp in der CLI oder der IDE-Erweiterung /skills, oder tipp $ und beginne mit dem Namen. In der ChatGPT-Desktop-App öffnest du Skills in der Seitenleiste. Codex erkennt neue Skills von selbst; erscheint einer nicht, starte Codex neu.

So führst du einen Skill in Codex aus

Tipp $, den Namen des Skills und dann deine Anfrage:

Codex CLI

$launch-page Parcelo, a parcel-tracking dashboard for small online shops

Sobald du weißt, dass er funktioniert, kannst du mit normalen Worten fragen, und Codex wählt den Skill, dessen Beschreibung passt. Bei vielen installierten Skills kürzt Codex die Beschreibungen, damit die ganze Liste in etwa 2 % des Kontextfensters passt. Stell den Hauptzweck in den ersten Satz der Beschreibung, damit er die Kürzung übersteht.

Wo Codex nach Skills sucht

Codex sammelt Skills aus fünf Bereichen. Im Alltag nutzt du zwei davon: deinen persönlichen Ordner und den des Repositorys.

Bereich	Ort
Repository	`.agents/skills/` in jedem Ordner vom Startort von Codex bis hinauf zum Repo-Root
Persönlich	`~/.agents/skills/`
Persönlich, älter	`~/.codex/skills/`, wird weiterhin gelesen (fehlt in der Doku, ist aber im Quellcode von Codex bestätigt)
Admin	`/etc/codex/skills/`
System	Mit Codex gebündelt, etwa `$skill-creator` und plan

Codex führt zwei Skills mit demselben Namen nicht zusammen. Beide können in der Auswahl erscheinen – lösch oder benenne die Kopie um, die du nicht willst.

Codex Skills vs. AGENTS.md

Codex liest AGENTS.md zu Beginn jedes Laufs, daher eignet sie sich für kurze Regeln, die immer gelten. Ein Skill lädt nur, wenn eine Aufgabe ihn verlangt, und eignet sich daher für längere Abläufe, die du wiederholst.

Skill

Geladen bei Bedarf

Ein Ordner in .agents/skills/
Lädt, wenn eine Aufgabe passt oder du $name tippst
Gut für wiederholbare, mehrstufige Arbeit

AGENTS.md

Zu Beginn jedes Laufs gelesen

Zuerst ~/.codex/AGENTS.md, dann eine Datei pro Ordner vom Repo-Root bis zu deinem Startort
Nähere Dateien überschreiben frühere; standardmäßig insgesamt 32 KiB
Gut für kurze Regeln: Testbefehle, Codestil, Grenzen

Eine Aufteilung, die gut funktioniert: Halte AGENTS.md bei etwa einer Bildschirmseite Regeln und verschieb alles Schritt-für-Schritt-Artige in Skills. Skills vs. Anweisungen geht tiefer.

Codex-Skill erscheint nicht? Finde dein Symptom

Ein fehlender Skill liegt meist im falschen Ordner oder wurde eine Ebene zu tief entpackt. Such in der linken Spalte, was du siehst.

Was du siehst	Lösung
Nicht in `/skills`	Verschieb ihn nach `~/.agents/skills/<name>/` und prüfe auf eine zusätzliche Ebene aus dem ZIP
Ohne Beschreibung gelistet	Korrigier das Frontmatter. Codex braucht sowohl `name` als auch `description`
Projekt-Skill fehlt	Starte Codex im Repository
`$` findet in der ChatGPT-Desktop-App nichts	Ein gemeldeter Bug (openai/codex#28505). Prüfe `/skills`, starte neu oder probier eine Kopie in `~/.codex/skills/` (das haben wir noch nicht getestet)

Häufige Fragen

Wo werden Codex-Skills gespeichert?

~/.agents/skills/ für deine eigenen Skills, .agents/skills/ in einem Repository und /etc/codex/skills/ für Admins. Codex liest auch das ältere ~/.codex/skills/, wo $skill-installer Skills ablegt.

Was ist der Unterschied zwischen Codex Skills und AGENTS.md?

AGENTS.md wird zu Beginn jedes Laufs gelesen. Ein Skill lädt nur, wenn eine Aufgabe ihn braucht.

Funktionieren Codex Skills in ChatGPT?

Eigenständige Skills funktionieren in der ChatGPT-Desktop-App, der Codex CLI und der IDE-Erweiterung. Um einen in ChatGPT im Web oder auf dem Smartphone zu nutzen, liefere ihn in einem Plugin aus.