Skills erstellen

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

Skills sind das Autorenformat für wiederverwendbare Arbeitsabläufe. Plugins verteilen wiederverwendbare Skills und Connectors über das universelle Plugin-Verzeichnis, das von ChatGPT und Codex gemeinsam genutzt wird. Plugins funktionieren in Chat und Work in ChatGPT im Web, auf Desktopgeräten und Mobilgeräten, in Codex in der ChatGPT-Desktop-App sowie über die Codex CLI. Entwerfen Sie mit Skills zunächst den eigentlichen Arbeitsablauf und bündeln Sie ihn anschließend als Plugin, wenn Sie möchten, dass andere ihn installieren können.

Eigenständige Skills sind in der ChatGPT-Desktop-App, der Codex CLI und der IDE-Erweiterung verfügbar. In Plugins gebündelte Skills sind außerdem in Chat und Work in ChatGPT im Web sowie auf Desktop- und Mobilgeräten verfügbar.

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

Skill-Auswahl mit verfügbaren Skills in der ChatGPT-Desktop-App im hellen Modus

Skills verwenden **schrittweise Offenlegung**, um den Kontext effizient zu verwalten. ChatGPT und Codex beginnen mit dem Namen und der Beschreibung jedes Skills und laden anschließend die vollständigen Anweisungen aus `SKILL.md`, wenn sie sich für die Verwendung dieses Skills entscheiden.

In Codex enthält die anfängliche Liste außerdem den Dateipfad jedes Skills. Damit der übrige Prompt nicht verdrängt wird, beansprucht 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 die Skill-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.

So verwenden ChatGPT und Codex Skills

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

Expliziter Aufruf: Geben Sie den Skill direkt in Ihrem Prompt an. Geben Sie in ChatGPT @ ein, um einen Skill auszuwählen. Führen Sie in Codex CLI oder der IDE-Erweiterung /skills aus oder geben Sie $ ein, um einen Skill zu erwähnen.
Impliziter Aufruf: ChatGPT oder Codex kann einen Skill auswählen, wenn Ihre Aufgabe der description des Skills entspricht.

Da der implizite Abgleich von description abhängt, sollten Sie prägnante Beschreibungen mit einem klaren Geltungsbereich und klaren Grenzen verfassen. Stellen Sie den wichtigsten Anwendungsfall und die Auslösewörter an den Anfang, damit ein Host den Skill auch dann noch 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 Record & Replay. Der Rekorder erfasst den Workflow, analysiert die Schritte und erstellt anhand der Demonstration einen wiederverwendbaren Skill-Entwurf.

Wenn Sie den Skill stattdessen beschreiben möchten, verwenden Sie den integrierten Ersteller. Rufen Sie ihn in ChatGPT Work mit @skill-creator auf. Rufen Sie ihn in Codex wie folgt auf:

$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 ChatGPT or Codex to follow.

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

Wo Codex lokale Skills lädt

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 Connectors bündeln möchten, verwenden Sie Plugins.

Skills mit Plugins verteilen

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

Plugins können einen oder mehrere Skills enthalten. Optional können sie außerdem registrierte MCP-Serververbindungen, eine gebündelte MCP-Serverkonfiguration und Präsentationsressourcen in einem einzigen Paket zusammenfassen.

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.

Lokale Codex-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 Agent-Skills-Spezifikation. Für eine installierbare Verteilung sollten Sie Plugins bevorzugen.

Letzte Suchanfragen

Suchvorschläge

Dokumentationsnavigation