ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

Skills erstellen

Verleihen Sie Codex neue Fähigkeiten und neues Fachwissen

Verwenden Sie Agenten-Skills, um Codex um aufgabenspezifische Fähigkeiten zu erweitern. Ein Skill bündelt Anweisungen, Ressourcen und optionale Skripte, damit Codex einen Workflow zuverlässig ausführen kann. Skills basieren auf dem offenen Standard für Agenten-Skills.

Skills sind das Autorenformat für wiederverwendbare Workflows. Plugins verteilen wiederverwendbare Skills und Konnektoren an ChatGPT Work im Web sowie an ChatGPT Work und Codex in der Desktop-App. Codex CLI kann ebenfalls Plugins installieren. Verwenden Sie Skills, um den eigentlichen Workflow zu entwerfen, und paketieren Sie ihn anschließend als Plugin, wenn andere Personen in Ihrem Arbeitsbereich ihn installieren können sollen.

Skills sind in der ChatGPT-Desktop-App, in Codex CLI und in der IDE-Erweiterung verfügbar.

Öffnen Sie in der ChatGPT-Desktop-App Skills in der Seitenleiste, um in Ihren Projekten erstellte Skills anzuzeigen und zu erkunden.

Skill-Auswahl mit verfügbaren Skills in der ChatGPT-Desktop-App (heller Modus)

Skills verwenden progressive Offenlegung, um den Kontext effizient zu verwalten: Codex beginnt mit dem Namen, der Beschreibung und dem Dateipfad jedes Skills. Codex lädt die vollständigen Anweisungen aus SKILL.md erst, wenn es sich für die Verwendung eines Skills entscheidet.

Codex nimmt eine anfängliche Liste verfügbarer Skills in den Kontext auf, damit es den richtigen Skill für eine Aufgabe auswählen kann. Damit der übrige Prompt nicht verdrängt wird, nutzt diese Liste höchstens 2 % des Kontextfensters des Modells oder 8.000 Zeichen, wenn die Größe des Kontextfensters unbekannt ist. Wenn viele Skills installiert sind, kürzt Codex zuerst deren Beschreibungen. Bei großen Skill-Sammlungen kann Codex einige Skills aus der anfänglichen Liste auslassen und eine Warnung anzeigen.

Dieses Budget gilt nur für die anfängliche Skill-Liste. Wenn Codex einen Skill auswählt, liest es weiterhin die vollständigen SKILL.md-Anweisungen dieses Skills.

Ein Skill ist ein Verzeichnis mit einer Datei SKILL.md sowie optionalen Skripten und Referenzen. Die Datei SKILL.md muss name und description enthalten.

my-skill/
├── SKILL.md          # Required: instructions and metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates and resources
└── agents/
    └── openai.yaml   # Optional: appearance and dependency declarations

So verwendet Codex Skills

Codex kann Skills auf zwei Arten aktivieren:

  1. Expliziter Aufruf: Nehmen Sie den Skill direkt in Ihren Prompt auf. Führen Sie in CLI/IDE /skills aus oder geben Sie $ ein, um einen Skill zu erwähnen.
  2. Impliziter Aufruf: Codex kann einen Skill auswählen, wenn Ihre Aufgabe dem description des Skills entspricht.

Da der implizite Abgleich von description abhängt, sollten Sie prägnante Beschreibungen mit eindeutigem Umfang und klaren Grenzen verfassen. Stellen Sie den wichtigsten Anwendungsfall und die Auslösebegriffe an den Anfang, damit Codex den Skill auch dann zuordnen kann, wenn Beschreibungen gekürzt werden.

Skill erstellen

Wenn Sie den Workflow bereits kennen und er sich leichter zeigen als beschreiben lässt, verwenden Sie Aufzeichnen und Wiedergeben. Codex zeichnet den Workflow auf, untersucht die Schritte und entwirft aus der Demonstration einen wiederverwendbaren Skill.

Wenn Sie den Skill stattdessen beschreiben möchten, verwenden Sie den integrierten Creator:

$skill-creator

Der Creator fragt, was der Skill tut, wann er ausgelöst werden soll und ob er nur Anweisungen enthalten oder auch Skripte einschließen soll. Standardmäßig enthält er nur Anweisungen.

Sie können einen Skill auch manuell erstellen, indem Sie einen Ordner mit einer Datei SKILL.md anlegen:

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

Skill instructions for Codex to follow.

Codex erkennt Änderungen an Skills automatisch. Wenn eine Aktualisierung nicht erscheint, starten Sie Codex neu.

Speicherorte für Skills

Codex liest Skills aus Repository-, Benutzer-, Administrator- und Systemspeicherorten. Bei Repositorys durchsucht Codex .agents/skills in jedem Verzeichnis vom aktuellen Arbeitsverzeichnis bis zum Repository-Stammverzeichnis. Wenn zwei Skills denselben name verwenden, führt Codex sie nicht zusammen; beide können in Skill-Auswahlfeldern erscheinen.

Skill-Gültigkeitsbereich Speicherort Empfohlene Verwendung
REPO $CWD/.agents/skills
Aktuelles Arbeitsverzeichnis: der Ort, an dem Sie Codex starten.		 Wenn Sie sich in einem Repository oder einer Codeumgebung befinden, können Teams Skills einchecken, die für einen Arbeitsordner relevant sind, beispielsweise Skills, die nur für einen Microservice oder ein Modul gelten.
REPO $CWD/../.agents/skills
Ein Ordner oberhalb des CWD, wenn Sie Codex innerhalb eines Git-Repositorys starten.		 In einem Repository mit verschachtelten Ordnern können Organisationen Skills einchecken, die für einen gemeinsamen Bereich in einem übergeordneten Ordner relevant sind.
REPO $REPO_ROOT/.agents/skills
Der oberste Stammordner, wenn Sie Codex innerhalb eines Git-Repositorys starten.		 In einem Repository mit verschachtelten Ordnern können Organisationen Skills einchecken, die für alle Benutzer des Repositorys relevant sind. Diese dienen als Stamm-Skills, die in jedem Unterordner des Repositorys verfügbar sind.
USER $HOME/.agents/skills
Alle Skills, die in den persönlichen Ordner des Benutzers eingecheckt wurden.		 Verwenden Sie diesen Bereich, um für einen Benutzer relevante Skills zusammenzustellen, die für jedes Repository gelten, in dem der Benutzer arbeitet.
ADMIN /etc/codex/skills
Alle Skills, die an einem gemeinsam genutzten Systemspeicherort auf dem Computer oder im Container eingecheckt wurden.		 Verwenden Sie diesen Bereich für SDK-Skripte und Automatisierung sowie zum Einchecken standardmäßiger Administrator-Skills, die jedem Benutzer des Computers zur Verfügung stehen.
SYSTEM Von OpenAI mit Codex gebündelt. Nützliche Skills für ein breites Publikum, beispielsweise die Skills zum Erstellen von Skills und Plänen. Sie stehen allen Benutzern beim Start von Codex zur Verfügung.

Codex unterstützt per Symlink verknüpfte Skill-Ordner und folgt beim Durchsuchen dieser Speicherorte dem Symlink-Ziel.

Diese Speicherorte dienen der Erstellung und lokalen Erkennung. Wenn Sie wiederverwendbare Skills über ein einzelnes Repository hinaus verteilen oder sie optional mit Konnektoren bündeln möchten, verwenden Sie Plugins.

Skills mit Plugins verteilen

Direkte Skill-Ordner eignen sich am besten für die lokale Erstellung und Repository-spezifische Workflows. Wenn Sie einen wiederverwendbaren Skill verteilen, zwei oder mehr Skills bündeln oder einen Skill zusammen mit einem Konnektor bereitstellen möchten, paketieren Sie sie als Plugin.

Plugins können einen oder mehrere Skills enthalten. Optional können sie auch App- Zuordnungen, die Konfiguration von MCP-Servern und Präsentationsressourcen in einem einzigen Paket bündeln.

Kuratierte Skills für die lokale Verwendung installieren

Um Ihrer eigenen lokalen Codex-Einrichtung zusätzlich zu den integrierten Skills kuratierte Skills hinzuzufügen, verwenden Sie $skill-installer. Um beispielsweise den Skill $linear zu installieren:

$skill-installer linear

Sie können den Installer außerdem anweisen, Skills aus anderen Repositorys herunterzuladen. Codex erkennt neu installierte Skills automatisch. Wenn einer nicht erscheint, starten Sie Codex neu.

Verwenden Sie dies für die lokale Einrichtung und zum Experimentieren. Für die wiederverwendbare Verteilung Ihrer eigenen Skills sollten Sie Plugins bevorzugen.

Skills aktivieren oder deaktivieren

Verwenden Sie [[skills.config]]-Einträge in ~/.codex/config.toml, um einen Skill zu deaktivieren, ohne ihn zu löschen:

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

Starten Sie Codex nach einer Änderung an ~/.codex/config.toml neu.

Optionale Metadaten

Fügen Sie agents/openai.yaml hinzu, um UI-Metadaten in der ChatGPT-Desktop-App zu konfigurieren, Aufrufrichtlinien festzulegen und Tool-Abhängigkeiten zu deklarieren, damit die Verwendung des Skills reibungsloser funktioniert.

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 (Standard: true): Wenn false festgelegt ist, ruft Codex den Skill nicht aufgrund des Benutzer-Prompts implizit auf; der explizite Aufruf mit $skill funktioniert weiterhin.

Bewährte Vorgehensweisen

  • Konzentrieren Sie jeden Skill auf eine Aufgabe.
  • Bevorzugen Sie Anweisungen gegenüber Skripten, sofern Sie kein deterministisches Verhalten oder externe Tools benötigen.
  • Formulieren Sie imperative Schritte mit expliziten Ein- und Ausgaben.
  • Testen Sie Prompts anhand der Skill-Beschreibung, um das richtige Auslöseverhalten zu bestätigen.

Weitere Beispiele finden Sie unter GitHub-CI-Reparatur, PDF, Linear, openai/skills und in der Spezifikation für Agenten-Skills. Für eine installierbare Verteilung sollten Sie Plugins bevorzugen.