Codex-Skills.
Ein Codex-Skill ist ein Ordner mit einer SKILL.md-Datei, die Codex eine bestimmte Art von Arbeit beibringt, etwa CI-Fehler beheben oder ein Design prüfen. Dieser Leitfaden zeigt, wo Skills liegen, wie du sie installierst und aufrufst, wie du einen schreibst, den Codex zur richtigen Zeit wählt, und welche du zuerst installieren solltest.
Aktualisiert am 12. November 2026 · 7 Min. Lesezeit
Die Kurzfassung
- Ein Skill ist ein Ordner mit einer
SKILL.md-Datei: einemname, einerdescriptionund Anweisungen in Markdown. Er kann außerdem Skripte und Referenzdateien enthalten. - Installieren kannst du ihn, indem du in Codex
$skill-installerund den Namen oder die GitHub-URL des Skills eingibst, oder indem du den Ordner nach~/.agents/skillskopierst. Starte Codex danach neu. - Verwenden kannst du ihn mit
/skillsoder indem du$und seinen Namen tippst. Codex wählt einen Skill auch selbst, wenn deine Anfrage zu seiner Beschreibung passt. - Schreiben kannst du ihn mit dem eingebauten
$skill-creator. Die Beschreibung entscheidet, wann Codex den Skill nutzt, also steck die meiste Zeit dorthin. - Der Katalog
openai/skillsvon OpenAI ist veraltet. Neue offizielle Skills kommen in Plugins im Repositoryopenai/plugins.
Was ein Codex-Skill ist
Ein Skill bündelt Anweisungen und optional Skripte und Ressourcen für eine Aufgabe. Codex liest zu Beginn einer Sitzung nur Name und Beschreibung jedes Skills. Passt eine Aufgabe zu einer Beschreibung oder nennst du den Skill beim Namen, lädt es die vollständige SKILL.md. Deshalb kannst du Dutzende Skills installiert haben, ohne das Kontextfenster zu füllen.
Skills folgen dem offenen Format Agent Skills. Derselbe Ordner funktioniert deshalb meist auch in anderen Agenten, die SKILL.md lesen, darunter Claude Code. Ein Plugin ist etwas anderes: ein installierbares Paket, das mehrere Skills sowie MCP-Server und Hooks enthalten kann. Den Unterschied erklärt Codex-Plugins vs. Skills.
Wo Codex-Skills liegen
| Ebene | Pfad | Wofür |
|---|---|---|
| Repository | .agents/skills im aktuellen Ordner oder darüber, bis zum Stamm des Repos | Skills, die zu einem Projekt gehören |
| Benutzer | ~/.agents/skills | Skills, die du in jedem Projekt haben willst |
| Organisation | /etc/codex/skills | Skills, die ein Admin für alle installiert |
| System | Mit Codex ausgeliefert | skill-creator, skill-installer und ein paar weitere |
Codex durchsucht jeden Ordner .agents/skills von dort, wo du es gestartet hast, bis zum Stamm des Repositorys. Zwei Skills mit demselben Namen werden nicht zusammengeführt; beide erscheinen in der Liste. Skill-Ordner als Symlinks funktionieren, praktisch, wenn du deine Skills in einem einzigen Git-Repository pflegst.
So verwendest du einen Skill
- Auswählen: Führe in der Codex CLI oder der IDE-Erweiterung
/skillsaus und wähle einen Skill. - Erwähnen: Tippe in deinem Prompt
$und den Namen des Skills, zum Beispiel$gh-fix-ci the build on this branch is red. - Codex wählen lassen: Beschreibe die Aufgabe ganz normal. Passt sie zur Beschreibung eines Skills, lädt Codex ihn selbst.
In der ChatGPT-Desktop-App tippst du statt $ ein @.
So installierst du Codex-Skills
Mit $skill-installer
$skill-installer ist ein System-Skill, der mit Codex kommt. Gib ihm einen Namen oder einen GitHub-Ordner:
$skill-installer gh-address-comments
$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui
Ein einfacher Name installiert aus dem kuratierten Katalog von OpenAI. Eine URL installiert aus jedem öffentlichen Repository. Starte Codex neu, wenn der neue Skill nicht erscheint.
Durch Kopieren des Ordners
Ein Skill besteht nur aus Dateien. Du kannst seinen Ordner also auch nach ~/.agents/skills (alle Projekte) oder .agents/skills (ein Projekt) klonen oder kopieren. So teilst du einen Skill am einfachsten mit deinem Team: Committe ihn ins Repository, und jeder, der das Projekt in Codex öffnet, hat ihn.
Aus einem Plugin
OpenAI hat das Repository openai/skills als veraltet markiert und liefert eigene Skills jetzt in Plugins aus, im Repository openai/plugins: Figma, Notion, Linear, GitHub, Vercel, Build Web Apps, Product Design und mehr. Führe in der Codex CLI /plugins aus, um sie zu durchsuchen und zu installieren. Ein Plugin installiert seine Skills und die Tools, die sie brauchen, in einem Schritt.
So schreibst du einen eigenen Skill
Am schnellsten gelingt der Start, wenn du Codex fragst:
$skill-creator Erstelle einen Skill auf Benutzerebene namens design-review. Er prüft einen UI-Screen anhand der DESIGN.md im Projekt: Farben und Schriften nur aus der Datei, ein 8-px-Abstandsraster, Fließtext mit mindestens 16 px und keine Emojis als Icons. Er meldet Probleme als Liste mit Datei und Zeile und behebt sie dann.
Oder schreibe die Datei selbst, in ~/.agents/skills/design-review/SKILL.md:
---
name: design-review
description: Review a UI screen against the project's DESIGN.md. Use when the user asks for a design review, says a screen looks off, or before finishing any UI change.
---
1. Read DESIGN.md. If there is none, say so and stop.
2. Check colors, fonts, spacing, and type sizes against it.
3. List each problem with the file and line, then fix it.
Drei Dinge entscheiden, ob Codex einen Skill nutzt oder ignoriert:
- Schreib die Beschreibung so, dass sie passt. Sag, was der Skill tut und wann man ihn einsetzt, in den Worten, die Leute wirklich tippen. „Use when the user asks for a design review“ funktioniert; „Design helper“ nicht.
- Halte die SKILL.md kurz. Lege lange Referenzen in einen Ordner
references/und sag dem Skill, wann er sie lesen soll. Codex lädt die zusätzlichen Dateien nur bei Bedarf. - Nimm Skripte für exakte Schritte. Was jedes Mal gleich ablaufen muss, etwa eine Prüfung oder eine Umwandlung, gehört in
scripts/, und der Skill führt es aus.
Damit Codex einen Skill nicht von selbst verwendet, $name aber weiter funktioniert, lege agents/openai.yaml mit policy: { allow_implicit_invocation: false } in den Skill-Ordner.
Codex-Skills, die sich lohnen
| Skill | Was er tut | So bekommst du ihn |
|---|---|---|
skill-creator, skill-installer | Skills erstellen und installieren | Eingebaut |
imagegen | Erzeugt Bilder aus einem Prompt direkt in Codex | Eingebaut |
gh-fix-ci | Liest fehlgeschlagene GitHub-Actions-Logs und behebt den Build | $skill-installer gh-fix-ci |
gh-address-comments | Arbeitet die Review-Kommentare an deinem offenen Pull Request ab | $skill-installer gh-address-comments |
playwright | Steuert einen echten Browser, um zu testen und Screenshots zu machen | $skill-installer playwright |
security-best-practices | Prüft Code auf häufige Sicherheitsfehler | $skill-installer security-best-practices |
| Figma-Skills | Machen aus Figma-Frames Code und aus Code Figma | Das Figma-Plugin, über /plugins |
| Taste Skill | Holt die UI weg vom generischen KI-Look | Siehe die Anleitung |
| pretty-ui | Prüft die UI auf typische KI-Design-Merkmale und behebt sie | $skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui |
Speziell für Design-Arbeit vergleichen wir die Möglichkeiten in den besten Codex-Skills für UI-Design und in Taste Skill vs. Impeccable vs. UI UX Pro Max.
Einen Skill abschalten oder reparieren, der nicht erscheint
Um einen Skill abzuschalten, ohne ihn zu löschen, füge Folgendes in ~/.codex/config.toml ein und starte Codex neu:
[[skills.config]]
path = "/Users/you/.agents/skills/design-review/SKILL.md"
enabled = false
Verwende name = "design-review" statt path, um jeden Skill mit diesem Namen abzuschalten.
Fehlt ein Skill in /skills:
- Starte Codex neu. Neue Skills werden beim Start einer Sitzung geladen.
- Prüfe den Ordner. Die Datei muss
SKILL.mdheißen und direkt im Ordner des Skills liegen, unter einem der oben genannten Pfade. - Prüfe das Frontmatter.
nameunddescriptionsind Pflicht. - Vielleicht sind es zu viele. Die Startliste der Skills bekommt etwa 2 % des Kontextfensters. Darüber kürzt Codex Beschreibungen und kann Skills weglassen, mit einer Warnung. Erhöhe das Budget mit
skills.max_context_tokensin derconfig.tomloder entferne Skills, die du nicht nutzt.
Häufige Fragen
Funktionieren Claude-Code-Skills in Codex?
Meistens ja. Beide nutzen das Format SKILL.md. Kopiere den Ordner aus ~/.claude/skills nach ~/.agents/skills. Ein Skill, der den Agenten anweist, ein Tool zu nutzen, das nur einer von beiden hat, muss angepasst werden.
Was ist der Unterschied zwischen einem Skill und AGENTS.md?
AGENTS.md wird in jeder Sitzung in diesem Projekt geladen und eignet sich daher für Regeln, die immer gelten. Ein Skill lädt nur, wenn eine Aufgabe ihn braucht. Er passt also zu Workflows, die du nur manchmal nutzt, und kann Skripte und Referenzdateien mitbringen.
Wo finde ich weitere Codex-Skills?
In den Plugins von OpenAI unter /plugins, im veralteten, aber noch lesbaren Repository openai/skills und in Skills, die Autoren auf GitHub veröffentlichen. Lies die Dateien eines Skills, bevor du ihn installierst, vor allem seine Skripte: Ein Skill läuft mit denselben Rechten wie Codex.
Weiterlesen
- Codex-Plugins vs. SkillsWas beides ist, wie sie zusammenhängen und wann du was nutzt.
- Die besten Codex-Skills für UI-DesignTaste Skill, Stil-Skills, Skills mit Bild-zuerst-Ansatz und wie du sie installierst.
- DESIGN.md für Codex und Claude CodeHalte dein Designsystem einmal fest, damit jeder Skill und jeder Screen es befolgt.