TECH. KI. KLARTEXT.
Tokenwerk

Technologie verstehen.
Besser entscheiden.

Tools, MCPs und Skills · Lektion 4 von 6

Skills nutzen und einen eigenen Ablauf beschreiben

Ein Skill hält einen wiederkehrenden Arbeitsablauf fest. Sein Nutzen hängt davon ab, ob Zweck, Eingaben, Grenzen und Ergebnis klar beschrieben sind.

30 Minuten · SchätzungEinrichten
Zusammenhang: Skills nutzen und einen eigenen Ablauf beschreiben. Übungsprojekt, .agents/skills/text-pruefen, SKILL.md, Passender Prüfauftrag
Übungsprojekt · .agents/skills/text-pruefen · SKILL.md · Passender Prüfauftrag

Nach dieser Lektion

Das kannst du prüfen.

Du liest einen Skill, beschreibst einen begrenzten eigenen Ablauf und prüfst, wann er verwendet werden soll.

Du brauchst
Texteditor. Für einen optionalen echten Versuch brauchst du einen Client mit Skill-Unterstützung. Die Schreibübung erfordert keine API.

Kurz erklärt

Ein Skill ist ein wiederverwendbarer Arbeitsablauf mit Anweisungen und optionalen weiteren Dateien. Beginne mit einem kleinen Textprüf-Auftrag. Beschreibe seine passenden Aufgaben, teste einen Gegenfall und prüfe die Ausgabe selbst. Ein Skill vergibt keine zusätzlichen Zugriffsrechte.

Ein Ablauf ist kein zusätzlicher Zugang

Ein Skill bündelt Anweisungen und gegebenenfalls unterstützende Dateien. MCP stellt dagegen einen Zugang zu angebotenen Daten oder Werkzeugen bereit. Beides kann zusammenarbeiten, hat aber unterschiedliche Aufgaben. Ein Skill kann auch ohne MCP sinnvoll sein.

Eine Anweisung, eine Datei zu ändern oder etwas zu versenden, erzeugt noch keine technische Berechtigung. Prüfe Rechte und konkrete Aktionen separat. Lies fremde Skills sowie enthaltene Skripte vor ihrer Verwendung; der Name allein erklärt nicht, was ausgeführt werden könnte.

Eine kleine Beschreibung statt eines Universal-Skills

Ein SKILL.md enthält Metadaten wie name und description sowie die eigentlichen Schritte. Beschreibe in der description, bei welcher Aufgabe der Ablauf passt. Grenzen gehören ebenfalls dazu: Unser Beispiel prüft einen kurzen Text gegen vorgegebene Fakten und versendet nichts.

Die Einbindung hängt vom Produkt ab. Der aktuelle Codex-Leitfaden beschreibt repositorybezogene Skills unter .agents/skills. API-Skillpakete und Plugins nutzen andere Einbindungswege. Übertrage deren Konfiguration nicht ungeprüft auf deinen lokalen Client. Der Guide zu Claude Skills zeigt einen weiteren produktspezifischen Einbindungsweg; übertrage ihn nicht unverändert auf Codex.

Markdown ist ein Textformat mit Überschriften und Listen. Speichere die Vorlage als SKILL.md, ohne zusätzliche .txt-Endung. Die beiden Zeilen mit --- begrenzen die Metadaten: name ist der kurze Skillname, description beschreibt passende Aufgaben. Darunter stehen die Arbeitsschritte. Im Beispiel gehört die Datei im Übungsprojekt nach .agents/skills/text-pruefen/SKILL.md.

Vom Lesen zum eigenen Versuch

So beginnst du.

Texteditor. Für einen optionalen echten Versuch brauchst du einen Client mit Skill-Unterstützung. Die Schreibübung erfordert keine API.

  1. 01

    Einen wiederkehrenden Job wählen

    Wähle eine kleine Aufgabe mit klaren Eingaben und einem überprüfbaren Ergebnis. Für den ersten Versuch reicht eine reine Anleitung ohne Skripte.

    Erkennbar an: Der Ablauf erledigt einen Job, nicht sämtliche denkbaren Aufgaben.

  2. 02

    Beschreibung und Schritte formulieren

    Nenne Auslöser, Eingangsmaterial, Prüfregeln und Ausgabeformat. Lege ausdrücklich fest, was bei fehlenden Angaben passieren soll.

    Erkennbar an: Eine andere Person könnte die Schritte mit denselben Daten nachvollziehen.

  3. 03

    Inhalt vor dem Einbinden lesen

    Lies alle Dateien und Verweise. Öffne dein eigenes Übungsprojekt und lege dort .agents/skills/text-pruefen an, mit dem passenden Ordnerbefehl unten. Speichere die Markdown-Vorlage darin als SKILL.md. Prüfe die sichtbare Dateiendung im Editor. Für andere Clients gelten deren dokumentierte Einbindungswege; die Website legt den Ordner nicht an.

    Erkennbar an: Du hast keine unbekannten Skripte oder unnötigen Rechte übernommen.

  4. 04

    Auslösung und Ergebnis getrennt testen

    Teste die passende Einladung in Codex CLI oder IDE ausdrücklich mit $text-pruefen. Beobachte, ob der Skill geladen wurde, und prüfe die Tabelle selbst. Sende danach den unpassenden Reiseauftrag ohne Skillnamen: So prüfst du die automatische Auswahl anhand der Beschreibung. In ChatGPT Work wird ein Skill über @ ausgewählt; die Bedienung hängt also vom Client ab.

    Erkennbar an: Du dokumentierst Trigger, Verhalten und Ergebnis getrennt.

Windows · Skill-Ordner anlegen

PowerShell

In deinem eigenen Übungsprojekt ausführen. Verwende nur den Befehl für dein Betriebssystem.

New-Item -ItemType Directory -Force -Path ".agents/skills/text-pruefen"
Als Textdatei ↓

macOS / Linux · Skill-Ordner anlegen

Terminal

Im eigenen Übungsprojekt. Danach die Datei SKILL.md mit dem Editor anlegen; die Ordneranlage allein installiert noch keine Anleitung.

mkdir -p .agents/skills/text-pruefen
Als Textdatei ↓

SKILL.md · kleiner Prüfablauf

Markdown

In .agents/skills/text-pruefen/SKILL.md speichern. Dies ist ein eigener Lernskill ohne Skripte; er vergibt keine zusätzlichen Rechte.

---
name: text-pruefen
description: Prüfe einen kurzen Entwurf gegen eine vom Nutzer mitgegebene Faktenliste. Nicht für freie Recherche oder neue Planungsaufgaben.
---

1. Lies Entwurf und Faktenliste. Fehlt eines davon, frage nach.
2. Vergleiche Daten, Orte, Beträge und Zusagen. Erfinde keine Ergänzungen.
3. Gib eine Tabelle mit Fundstelle, Abweichung und Korrekturhinweis aus.
4. Ändere keine Datei und sende keine Nachricht.
5. Kennzeichne offene Angaben ausdrücklich als offen.
Als Textdatei ↓

Passenden Auftrag ausdrücklich testen

Prompt

Für Codex CLI / IDE. Erwartete Abweichung: Freitag statt Donnerstag. Uhrzeit, Raum und kostenloser Eintritt stimmen. Prüfe zusätzlich, ob der Skill tatsächlich geladen wurde.

$text-pruefen
Prüfe diese Einladung gegen meine Faktenliste.
Faktenliste: Donnerstag, 19 Uhr, Raum 4, kein Eintritt.
Entwurf: Am Freitag treffen wir uns um 19 Uhr in Raum 4. Eintritt frei.
Als Textdatei ↓

Unpassenden Auftrag ohne Skillnamen testen

Prompt

Dieser Auftrag enthält keine Textprüfung gegen Fakten. Beobachte, ob dein Client den Textprüf-Skill trotzdem auswählt. Fehlende Eingaben oder unerwartetes Verhalten sind ein Anlass, die Beschreibung nachzubessern.

Plane mir eine neue Reise.
Als Textdatei ↓
Herstellerunterlagen zu diesen Schritten · geprüft 19.10.2026

Die Installation und ein echter Modelllauf wurden für dieses Lernmaterial nicht auf deinem Gerät ausgeführt. Die Grafiken erklären den Ablauf; sie sind keine Screenshots oder Leistungsmessungen.

Von der Datei zum beobachteten Verhalten

  1. Übungsprojekt
  2. .agents/skills/text-pruefen
  3. SKILL.md
Beschreibung
Passt der Textprüf-Auftrag zur description?
Aktivierung
Wurde der Skill im eigenen Versuch geladen?
Ausgabe
Wird Freitag gegen Donnerstag als Abweichung erkannt?
Eigener Lernskill und erfundene Faktenliste. Die Darstellung installiert nichts.

Jetzt bist du dran

Deinen ersten Textprüf-Skill entwerfen

Lies den Beispielskill und ergänze eine Regel, die zur Prüfung passt. Bearbeite den passenden Test zunächst auf Papier. Für den unpassenden Auftrag beschreibst du, warum dieser Skill nicht benötigt wird.

Dein Übungsmaterial

Eigenes Lernbeispiel · keine echten Kundendaten

Passender Test: ‚Prüfe diese Einladung gegen meine Faktenliste.‘
Unpassender Test: ‚Plane mir eine neue Reise.‘
Faktenliste: Donnerstag, 19 Uhr, Raum 4, kein Eintritt.
Entwurf: ‚Am Freitag treffen wir uns um 19 Uhr in Raum 4. Eintritt frei.‘
Übungsblatt als Textdatei herunterladen ↓

Optionaler Arbeitsauftrag

Für deinen eigenen Versuch. Diese Seite führt den Auftrag nicht aus.

---
name: text-pruefen
description: Prüfe einen kurzen Entwurf gegen eine vom Nutzer mitgegebene Faktenliste. Nicht für freie Recherche oder neue Planungsaufgaben.
---

1. Lies Entwurf und Faktenliste. Fehlt eines davon, frage nach.
2. Vergleiche Daten, Orte, Beträge und Zusagen. Erfinde keine Ergänzungen.
3. Gib eine Tabelle mit Fundstelle, Abweichung und Korrekturhinweis aus.
4. Ändere keine Datei und sende keine Nachricht.
5. Kennzeichne offene Angaben ausdrücklich als offen.
Lösungshinweis und mögliche Lösung
  • Die Abweichung ist Freitag statt Donnerstag. Uhrzeit, Raum und kostenloser Eintritt stimmen überein.
  • Eine passende Zusatzregel wäre: ‚Eine fehlende Jahresangabe nicht selbst ergänzen.‘ Sie begrenzt den Prüfauftrag, ohne eine neue Aufgabe zu erfinden.
  • Die Reiseplanung passt nicht zur Beschreibung. Für einen echten Test musst du zusätzlich beobachten, ob dein Client den Skill auswählt und die Prüftabelle erzeugt.

Achte darauf: Aus einer allgemein klingenden Beschreibung schließen, dass ein Skill automatisch bei jeder Aufgabe zuverlässig aktiviert wird.

Du bist fertig, wenn Dein Skill hat einen passenden Trigger, klare Grenzen und eine beobachtbare Ausgabe. Geplante und wirklich ausgeführte Tests bleiben unterscheidbar.

Ein kurzer Selbsttest

Hast du den Unterschied erkannt?

Was ergänzt ein Skill zu einem MCP-Zugang?

Das Häkchen ist deine eigene Einschätzung. Speichern ist unten freiwillig.

Im Lernpfad Tools, MCPs und Skills steht dieser Ablauf neben MCP-Zugängen und begrenzten Agentenrechten. So kannst du Anweisung, Verbindung und technische Berechtigung auseinanderhalten.

Häufige Fragen

Erstellt diese Übung automatisch einen installierten Skill?

Nein. Sie zeigt einen Textentwurf. Einen optionalen Ordner und die Einbindung in einen kompatiblen Client richtest du gesondert ein.

Muss ein Skill Skripte enthalten?

Nein. Für diesen Textprüf-Ablauf genügt eine Anleitung. Zusätzliche Skripte benötigen einen nachvollziehbaren Zweck und eine Prüfung.

Warum teste ich einen unpassenden Auftrag?

Damit du erkennst, ob die Beschreibung den Ablauf ausreichend begrenzt. Ein Skill soll nicht unnötig bei fachfremden Aufgaben verwendet werden.

Wo liegt die SKILL.md für die Codex-Übung?

Im eigenen Übungsprojekt unter .agents/skills/text-pruefen/SKILL.md. Prüfe die echte Dateiendung und verwende den dokumentierten Einbindungsweg deines Clients.

Warum teste ich Skill-Auswahl und Ergebnis getrennt?

Ein geladener Skill kann trotzdem eine falsche Prüftabelle erzeugen. Kontrolliere deshalb sowohl seine beobachtete Aktivierung als auch die Ausgabe gegen die vorgegebene Faktenliste.

Verständlichkeit, Lernführung und FAQs redaktionell geprüft am . Die technischen Quellenstände stehen bei den jeweiligen Anleitungen. Beispiele bleiben als eigene Übungsfälle gekennzeichnet.

Quellen & Einordnung · 19. Oktober 2026

Weiterlesen und Angaben prüfen.

Das SKILL.md-Beispiel und die Einladung sind eigene Lernmaterialien. Die API-Quellen und der Produktleitfaden behandeln unterschiedliche Einbindungen. Der Beispielskill wurde für diese Lektion nicht in deinem Client installiert oder ausgeführt. Der konkrete Einrichtungsablauf wurde am 19.10.2026 erneut mit den im Schrittabschnitt verlinkten aktuellen Herstellerunterlagen abgeglichen; die ursprüngliche Quellenrecherche stammt vom 14.10.2026.

Optional · nur dieser Browser

An deiner Stelle weiterlernen.

Die Einheiten bleiben ohne Anmeldung nutzbar. Erst nach deinem Klick merkt sich dieser Browser deine Häkchen. Du kannst sie jederzeit löschen. Quizantworten werden nicht gespeichert oder versendet.

Fortschritt wird aktuell nicht gespeichert.