Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Skills erstellen

Erweitere ChatGPT und Codex um neue Funktionen und Fachwissen

Mit Agenten-Skills kannst du ChatGPT und Codex um Funktionen für bestimmte Aufgaben erweitern. Ein Skill bündelt Anweisungen, Ressourcen und bei Bedarf Skripte, damit beide Produkte einen Arbeitsablauf zuverlässig ausführen können. Skills basieren auf dem offenen Standard für Agenten-Skills.

Mit Skills beschreibst du wiederverwendbare Arbeitsabläufe. Über das gemeinsame Plugin-Verzeichnis von ChatGPT und Codex kannst du wiederverwendbare Skills und Konnektoren als Plugins bereitstellen. Plugins funktionieren in den Modi Chat und Work in ChatGPT im Web, auf dem Desktop und auf Mobilgeräten. Du kannst sie auch in Codex in der ChatGPT-Desktop-App und über die Codex CLI verwenden. Erstelle zunächst den Arbeitsablauf als Skill. Wenn andere ihn installieren sollen, stelle ihn als Plugin bereit.

Eigenständige Skills sind in der ChatGPT-Desktop-App, in der Codex CLI und in der IDE-Erweiterung verfügbar. Skills, die zu einem Plugin gehören, kannst du außerdem in den Modi Chat und Work in ChatGPT im Web, auf dem Desktop und auf Mobilgeräten verwenden.

Öffne in der Seitenleiste der ChatGPT-Desktop-App Skills, um die in deinen Projekten erstellten Skills anzusehen und zu durchsuchen.

Skills stellen Informationen schrittweise bereit, um das Kontextfenster effizient zu nutzen. ChatGPT und Codex laden zunächst den Namen und die Beschreibung jedes Skills. Erst wenn sie sich für einen Skill entscheiden, laden sie die vollständigen Anweisungen aus SKILL.md.

In Codex enthält die anfängliche Liste auch den Dateipfad jedes Skills. Standardmäßig belegt die Liste höchstens 2 % des Kontextfensters des Modells. Ist dessen Größe unbekannt, gilt eine Obergrenze von 8.000 Zeichen. Sind viele Skills installiert, kürzt Codex zuerst die Beschreibungen. Bei sehr vielen Skills kann Codex einzelne Skills aus der anfänglichen Liste auslassen und eine Warnung anzeigen.

Mit skills.max_context_tokens kannst du ein anderes Limit von bis zu 10.000 Token festlegen.

Dieses Limit gilt nur für die anfängliche Liste. Sobald Codex einen Skill auswählt, liest Codex alle Anweisungen in der zugehörigen Datei SKILL.md.

Ein Skill besteht aus einem Verzeichnis mit einer SKILL.md-Datei und optionalen Skripten und Referenzmaterialien. Die Datei SKILL.md muss die Felder name und description enthalten.

  • my-skill/
    • SKILL.md Erforderlich: Anweisungen und Metadaten
    • scripts/ Optional: ausführbarer Code
    • references/ Optional: Dokumentation
    • assets/ Optional: Vorlagen und Ressourcen
    • agents/
      • openai.yaml Optional: Darstellung und Abhängigkeiten

So verwenden ChatGPT und Codex Skills

ChatGPT und Codex können Skills auf zwei Arten aufrufen:

  1. Expliziter Aufruf: Gib den Skill direkt in deinem Prompt an. Tippe in ChatGPT @, um einen Skill auszuwählen. Führe in der Codex CLI oder der IDE-Erweiterung /skills aus oder tippe $, um einen Skill zu erwähnen.
  2. Impliziter Aufruf: ChatGPT oder Codex kann einen Skill auswählen, wenn deine Aufgabe zur Beschreibung im Feld description passt.

Da die automatische Auswahl von description abhängt, beschreibe kurz und klar, wofür der Skill gedacht ist und wo seine Grenzen liegen. Nenne den wichtigsten Anwendungsfall und die relevanten Schlüsselwörter gleich am Anfang. So kann ein Host den passenden Skill auch dann erkennen, wenn die Beschreibungen gekürzt werden.

Einen Skill erstellen

Wenn du den Arbeitsablauf schon kennst und ihn leichter zeigen als beschreiben kannst, verwende Aufzeichnen und Wiedergeben. Die Funktion zeichnet den Ablauf auf, analysiert die einzelnen Schritte und erstellt daraus einen Entwurf für einen wiederverwendbaren Skill.

Wenn du den Skill lieber beschreiben möchtest, verwende den integrierten Assistenten zum Erstellen von Skills. In ChatGPT Work rufst du ihn mit @skill-creator auf. In Codex verwendest du dafür:

$skill-creator

Der Assistent fragt dich, was der Skill tun soll, wann er zum Einsatz kommen soll und ob er nur Anweisungen oder auch Skripte enthalten soll. Standardmäßig enthält der Skill nur Anweisungen.

Du kannst einen Skill auch manuell erstellen. Lege dazu einen Ordner mit einer SKILL.md-Datei an:

---
name: skill-name
description: Explain exactly when this skill should and should not trigger.
---

Skill instructions for ChatGPT or Codex to follow.

Codex erkennt Änderungen an Skills automatisch. Wenn eine Änderung nicht angezeigt wird, starte Codex neu.

Woher Codex lokale Skills lädt

Codex lädt Skills aus dem Repository sowie aus persönlichen, administrativen und systemweiten Verzeichnissen. In einem Repository sucht Codex auf jeder Verzeichnisebene nach .agents/skills, vom aktuellen Arbeitsverzeichnis bis zum Stammverzeichnis des Repositorys. Haben zwei Skills denselben Wert im Feld name, führt Codex sie nicht zusammen. Beide können in der Skill-Auswahl erscheinen.

Geltungsbereich Speicherort Empfohlene Verwendung
REPO $CWD/.agents/skills
Das aktuelle Arbeitsverzeichnis, in dem du Codex startest.
In einem Repository oder einer Entwicklungsumgebung kann dein Team hier Skills für einen bestimmten Arbeitsordner einchecken, etwa für einen einzelnen Microservice oder ein Modul.
REPO $CWD/../.agents/skills
Der Ordner eine Ebene über dem aktuellen Arbeitsverzeichnis, wenn du Codex in einem Git-Repository startest.
In einem Repository mit verschachtelten Ordnern kann deine Organisation Skills für einen gemeinsam genutzten Bereich im übergeordneten Ordner einchecken.
REPO $REPO_ROOT/.agents/skills
Das Stammverzeichnis des Git-Repositorys, in dem du Codex startest.
In einem Repository mit verschachtelten Ordnern kann deine Organisation hier Skills für alle einchecken, die mit dem Repository arbeiten. Skills im Stammverzeichnis stehen in jedem Unterordner des Repositorys zur Verfügung.
USER $HOME/.agents/skills
Alle Skills, die in deinem persönlichen Ordner eingecheckt sind.
Stelle hier deine persönlichen Skills zusammen, die du in jedem Repository verwenden kannst.
ADMIN /etc/codex/skills
Alle Skills, die in einem gemeinsamen Systemverzeichnis auf dem Rechner oder im Container eingecheckt sind.
Nutze diesen Speicherort für SDK-Skripte und Automatisierungen. Hier kannst du auch administrative Standard-Skills einchecken, die allen auf dem Rechner zur Verfügung stehen.
SYSTEM Von OpenAI mit Codex ausgeliefert. Dazu gehören skill-creator und skill-installer. Die System-Skills sind standardmäßig aktiviert.

Codex unterstützt symbolische Links auf Skill-Ordner. Beim Durchsuchen dieser Speicherorte folgt Codex dem Link zum Zielordner.

An diesen Speicherorten kannst du Skills erstellen, die Codex lokal findet. Wenn du wiederverwendbare Skills über ein einzelnes Repository hinaus bereitstellen oder sie mit Konnektoren bündeln möchtest, verwende Plugins.

Skills als Plugins bereitstellen

Einzelne Skill-Ordner eignen sich am besten, wenn du Skills lokal erstellst oder Arbeitsabläufe für ein bestimmtes Repository definierst. Wenn du einen wiederverwendbaren Skill verteilen, zwei oder mehr Skills bündeln oder einen Skill zusammen mit einem Konnektor bereitstellen möchtest, erstelle daraus ein Plugin.

Ein Plugin kann einen oder mehrere Skills enthalten. Bei Bedarf kannst du im selben Paket auch registrierte Verbindungen zu MCP-Servern, die mitgelieferte Konfiguration für MCP-Server und Dateien für die Darstellung bündeln.

Kuratierte Skills lokal installieren

Wenn du deine lokale Codex-Installation über die integrierten Skills hinaus um kuratierte Skills ergänzen möchtest, verwende $skill-installer. Den Skill $linear installierst du zum Beispiel so:

$skill-installer linear

Du kannst den Installer auch per Prompt auffordern, Skills aus anderen Repositorys herunterzuladen. Codex erkennt neu installierte Skills automatisch. Wenn ein Skill nicht angezeigt wird, starte Codex neu.

Nutze den Installer für dein lokales Setup und zum Ausprobieren. Wenn du deine eigenen Skills zur Wiederverwendung bereitstellen möchtest, verwende vorzugsweise Plugins.

Lokale Codex-Skills aktivieren oder deaktivieren

Mit [[skills.config]]-Einträgen in ~/.codex/config.toml kannst du einen Skill deaktivieren, ohne ihn zu löschen:

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Verwende pro Eintrag genau ein Auswahlkriterium. Mit einem absoluten Pfad in path wählst du eine einzelne SKILL.md-Datei aus. Mit name wählst du alle Skills mit diesem Namen aus. Treffen mehrere Einträge auf einen Skill zu, gilt der letzte passende Eintrag.

Um alle mitgelieferten System-Skills für das aktuelle Projekt zu deaktivieren, füge die folgende Einstellung in die vertrauenswürdige Konfigurationsdatei .codex/config.toml des Projekts ein:

[skills.bundled]
enabled = false

Starte Codex neu, nachdem du die Konfiguration geändert hast.

Optionale Metadaten

Füge agents/openai.yaml hinzu, um festzulegen, wie der Skill in der ChatGPT-Desktop-App angezeigt wird, wie er aufgerufen werden darf und welche Tools er benötigt. Damit erleichterst du die Verwendung des Skills.

interface:
  display_name: "Optional user-facing name"
  short_description: "Optional user-facing description"
  icon_small: "./assets/small-logo.svg"
  icon_large: "./assets/large-logo.png"
  brand_color: "#3B82F6"
  default_prompt: "Optional surrounding prompt to use the skill with"

policy:
  allow_implicit_invocation: false

dependencies:
  tools:
    - type: "mcp"
      value: "openaiDeveloperDocs"
      description: "OpenAI Docs MCP server"
      transport: "streamable_http"
      url: "https://developers.openai.com/mcp"

allow_implicit_invocation hat den Standardwert true. Bei false ruft Codex den Skill nicht automatisch anhand deines Prompts auf. Mit $skill kannst du ihn weiterhin explizit aufrufen.

Bewährte Vorgehensweisen

  • Beschränke jeden Skill auf eine Aufgabe.
  • Verwende vorzugsweise Anweisungen. Skripte sind sinnvoll, wenn du deterministisches Verhalten oder externe Tools benötigst.
  • Formuliere die Schritte als direkte Aufforderungen und gib für jeden Schritt die erwarteten Eingaben und Ausgaben an.
  • Teste anhand von Prompts, ob die Beschreibung dazu führt, dass der Skill in den vorgesehenen Fällen aufgerufen wird.

Weitere Beispiele findest du in den Skills CI-Fehler auf GitHub beheben, PDF und Linear, im Repository openai/skills und in der Spezifikation für Agenten-Skills. Wenn andere deine Skills installieren sollen, stelle sie vorzugsweise als Plugins bereit.