Zum Inhalt springen
Codex DesignBETA

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: einem name, einer description und Anweisungen in Markdown. Er kann außerdem Skripte und Referenzdateien enthalten.
  • Installieren kannst du ihn, indem du in Codex $skill-installer und den Namen oder die GitHub-URL des Skills eingibst, oder indem du den Ordner nach ~/.agents/skills kopierst. Starte Codex danach neu.
  • Verwenden kannst du ihn mit /skills oder 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/skills von OpenAI ist veraltet. Neue offizielle Skills kommen in Plugins im Repository openai/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

EbenePfadWofür
Repository.agents/skills im aktuellen Ordner oder darüber, bis zum Stamm des ReposSkills, die zu einem Projekt gehören
Benutzer~/.agents/skillsSkills, die du in jedem Projekt haben willst
Organisation/etc/codex/skillsSkills, die ein Admin für alle installiert
SystemMit Codex ausgeliefertskill-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 /skills aus 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 mit $skill-creator erstellen
$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

SkillWas er tutSo bekommst du ihn
skill-creator, skill-installerSkills erstellen und installierenEingebaut
imagegenErzeugt Bilder aus einem Prompt direkt in CodexEingebaut
gh-fix-ciLiest fehlgeschlagene GitHub-Actions-Logs und behebt den Build$skill-installer gh-fix-ci
gh-address-commentsArbeitet die Review-Kommentare an deinem offenen Pull Request ab$skill-installer gh-address-comments
playwrightSteuert einen echten Browser, um zu testen und Screenshots zu machen$skill-installer playwright
security-best-practicesPrüft Code auf häufige Sicherheitsfehler$skill-installer security-best-practices
Figma-SkillsMachen aus Figma-Frames Code und aus Code FigmaDas Figma-Plugin, über /plugins
Taste SkillHolt die UI weg vom generischen KI-LookSiehe die Anleitung
pretty-uiPrü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.md heißen und direkt im Ordner des Skills liegen, unter einem der oben genannten Pfade.
  • Prüfe das Frontmatter. name und description sind 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_tokens in der config.toml oder 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

Ein unabhängiges Plugin für Codex. Nicht mit OpenAI verbunden und nicht von OpenAI unterstützt.