Ein Skill ergänzt deinen MCP-Server. Er zeigt ChatGPT und Codex, wie sie die Tools des Servers in einem wiederholbaren Arbeitsablauf einsetzen. Nutze den Server für aktuelle Daten, Authentifizierung, Autorisierung und die kontrollierte Ausführung von Aktionen. Lege im Skill fest, in welcher Reihenfolge die Tools zum Einsatz kommen, wann Entscheidungen anstehen und welche Anforderungen die Ausgabe erfüllen muss. Ergänze Beispiele, Vorlagen und weitere wiederverwendbare Hinweise.
Ein Plugin kann einen einzelnen Skill oder mehrere zusammengehörige Skills enthalten. Wähle für jeden Skill ein klar erkennbares Nutzerziel aus deiner Übersicht der Anwendungsfälle. Ein Skill funktioniert auch ohne MCP-Server, wenn für den Arbeitsablauf die mitgelieferten Anweisungen und Ressourcen ausreichen.
Einen Skill erstellen
Am schnellsten erstellst du einen Skill mit dem integrierten Assistenten. Beschreibe das Nutzerziel und die MCP-Tools, die dabei helfen, es zu erreichen.
@skill-creator Erstelle einen Skill namens tabletop-dice, der Würfelnotationen
wie 3d6 versteht, für jeden Würfel genau einmal roll_dice aufruft und das
Ergebnis jedes Wurfs sowie die Summe ausgibt.
In Codex rufst du denselben Assistenten mit $skill-creator auf.
Du kannst die Dateien auch manuell anlegen. Jeder Skill hat ein eigenes Verzeichnis und benötigt eine Datei namens SKILL.md.
-
skills
-
tabletop-dice
- SKILL.md Erforderliche Anweisungen und Metadaten
- references Optionale Dokumentation
- scripts Optionaler ausführbarer Code
- assets Optionale Vorlagen und Ressourcen
-
-
SKILL.md schreiben
Beginne die Datei mit einem Namen und einer Beschreibung. Danach folgen die Anweisungen.
---
name: tabletop-dice
description: Roll one or more dice for tabletop games and report each result and the total.
---
Nutze diesen Skill, wenn dich jemand zum Würfeln auffordert.
1. Lies Angaben der Form `NdS` als N Würfel mit jeweils S Seiten. Zum Beispiel
steht `3d6` für drei sechsseitige Würfel.
2. Rufe `roll_dice` für jeden angeforderten Würfel genau einmal auf und übergib S als Wert für `sides`.
3. Gib jedes Tool-Ergebnis in der Reihenfolge der Aufrufe aus.
4. Sind in der Anfrage mehrere Würfel angegeben, addiere die Ergebnisse und gib die Summe aus.
Erfinde oder ersetze ein Ergebnis nur, wenn die anfragende Person dich darum bittet. Würfle auch nur auf ihre Bitte hin erneut.
Die Beschreibung bestimmt, wann das Modell den Skill in Betracht zieht. Beschreibe den Arbeitsablauf und die Bedingungen, unter denen er starten soll. Detaillierte Anweisungen zu Vorgehen, Format und Sicherheit gehören in den Hauptteil.
Den Arbeitsablauf abgrenzen
Ordne jeden Skill einem oder mehreren Anwendungsfällen zu. Beantworte in den Anweisungen folgende Fragen.
- Welche Eingaben setzt der Arbeitsablauf voraus?
- Welche Schritte soll das Modell ausführen?
- Welche Ausgabe soll die Person erhalten, die die Anfrage stellt?
- Welche Fakten darf das Modell nicht selbst ableiten?
- Wann soll das Modell nachfragen, den Arbeitsablauf beenden oder die Anfrage ablehnen?
- Welche ergänzenden Dateien soll das Modell heranziehen?
Konzentriere dich bei jedem Skill auf ein klar umrissenes Ziel. Vermeide umfangreiche Sammlungen von Anweisungen, die nur lose zusammenhängen. Trenne Arbeitsabläufe, wenn sie unterschiedliche Auslöser, Eingaben oder Erfolgskriterien haben.
Prüfen, wie das Modell Anweisungen befolgt
Wenn du Skills für GPT-6 Astra schreibst oder importierst, lies die Hinweise zum Befolgen von Anweisungen. Prüfe die Skills und ihre ergänzenden Dateien auf unklare oder widersprüchliche Anweisungen. Stelle klar, dass ausdrückliche Anweisungen der anfragenden Person Vorrang vor den Richtlinien des Skills haben.
Ergänzende Ressourcen hinzufügen
Halte SKILL.md kurz und lege ausführlichere Inhalte im selben Skill-Verzeichnis ab.
- Nutze
references/für Richtlinien, Schemata, Beispiele und Hintergrundinformationen. - Nutze
assets/für Vorlagen oder Dateien, die im Arbeitsablauf kopiert oder umgewandelt werden sollen. - Nutze
scripts/, wenn der Arbeitsablauf deterministische Berechnungen oder die Verarbeitung von Dateien erfordert.
Verweise in SKILL.md auf die ergänzenden Dateien und erkläre, wann das Modell sie laden oder ausführen soll. Verzichte auf ein Skript, wenn das Modell die Aufgabe mit den Anweisungen und den vorhandenen Tools zuverlässig erledigen kann.
Skills mit MCP-Tools verbinden
Ein Skill kann dem Modell zeigen, wie es die Tools einsetzt, die der MCP-Server des Plugins bereitstellt. Beschreibe den Arbeitsablauf im Skill. Nutze den Server für aktuelle Daten, Autorisierung und die kontrollierte Ausführung von Aktionen.
Wenn ein Skill einen MCP-Server benötigt, gib die Abhängigkeit in agents/openai.yaml an.
dependencies:
tools:
- type: "mcp"
value: "dice-roller"
description: "Roll an N-sided die"
transport: "streamable_http"
url: "https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp"
Wenn du die Abhängigkeit angibst, steht das benötigte Tool zur Verfügung. Klare Anweisungen zum Arbeitsablauf sind weiterhin nötig. Erkläre dem Modell, welche Tools es in welcher Reihenfolge verwenden soll und wie es mit fehlenden oder mehrdeutigen Ergebnissen umgehen soll.
Den Skill testen
Teste den Skill mit typischen Anfragen aus deiner Übersicht der Anwendungsfälle.
- Direkte Anfragen, die den Skill auslösen sollen.
- Indirekte Anfragen, die dasselbe Ziel ausdrücken.
- Unvollständige Eingaben, bei denen das Modell nachfragen soll.
- Anfragen, die den Skill nicht auslösen sollen.
- Grenzfälle, in denen das Modell weder Informationen erfinden noch eine nicht unterstützte Aktion ausführen darf.
Prüfe, wann der Skill zum Einsatz kommt und wie gut die Ausgaben sind. Präzisiere die Beschreibung, wenn das Modell den Skill zum falschen Zeitpunkt aktiviert. Präzisiere die Anweisungen, wenn das Modell den richtigen Arbeitsablauf wählt, aber uneinheitliche Ergebnisse liefert.
Den Skill als Paket bereitstellen
Gib im Manifest des Plugins den Pfad zum Verzeichnis mit den Skills an.
{
"name": "dice-roller",
"version": "1.0.0",
"description": "Roll dice for tabletop games",
"skills": "./skills/",
"apps": "./.app.json"
}
Die Anleitung Dein Plugin als Paket bereitstellen zeigt das vollständige Manifest und erklärt, wie du MCP-Server zuordnest, das Plugin lokal testest und es verteilst.