Niemand sagt dir, dass Prompts nicht skalieren. Du tüftelst den perfekten Prompt aus, er funktioniert genau einmal – und löst sich auf, sobald du den Tab schließt. Agent Skills lösen genau dieses Problem. Ein Skill ist ein wiederverwendbarer, versionierter Ordner, den dein Agent bei Bedarf lädt: einmal schreiben, und Claude Code wie Codex führen ihn aus. Statt fünfzig Einzeiler-Ideen aufzulisten, baut dieser Artikel acht Skills, die du zuerst haben solltest – jeder mit echter SKILL.md-Syntax und dem Aufruf, der ihn zündet. Eine kurze Bibliothek, die du wirklich fertigstellst, schlägt eine lange, die du nie schreibst.
Warum sich das als Standard und nicht als Trick zu lernen lohnt: Skills sind anbieterübergreifend. Anthropic hat Agent Skills vorgestellt und OpenAI hat Skills in Codex integriert – auf demselben Format. Gleicher Ordner, viele Agenten: Ein Skill, den du heute schreibst, überlebt also jedes Harness, das du diese Woche gerade verwendest.
Was ein Skill ist – und wie er sich von einem Prompt unterscheidet
Ein Skill ist ein Verzeichnis mit genau einer Pflichtdatei: SKILL.md. Diese Datei enthält YAML-Frontmatter – mindestens einen name und eine description – gefolgt von Anweisungen in normaler Sprache. Daneben können weitere Ordner liegen: scripts/ für echten Code, references/ für Tiefen-Doku und assets/ für Vorlagen. Ein Minimalbeispiel:
---
name: invoice-chaser
description: Draft polite payment-reminder emails for overdue invoices, escalating tone by days late. Trigger on "chase overdue invoices".
---
Read the overdue-invoice CSV. For each row, draft an email that names the
invoice, the amount, and the days overdue, with tone set by how late it is.
Ein Prompt ist etwas, das du eintippst. Ein Skill ist etwas, das dein Agent besitzt. Drei Unterschiede sind entscheidend:
- Skills bleiben bestehen und werden versioniert. Sie leben in Git, durchlaufen Reviews und reisen mit deinem Repo mit. Dein Prompt-Verlauf tut das nicht.
- Skills führen Code aus, nicht nur Text. Ein Skill kann ein Script bündeln, das ein PDF-Formular ausfüllt oder eine Tabelle umformt – etwas, das ein Modell durch reines „Nachdenken" nicht zuverlässig kann.
- Skills laden per Progressive Disclosure. Der Agent sieht zunächst nur Name und Beschreibung jedes Skills und liest den vollständigen Inhalt erst, wenn eine Aufgabe passt. Ein Regal voller Skills bläht deinen Kontext also nicht auf; genau diese Zurückhaltung ist der Sinn.
Deshalb trägt die description so viel Gewicht. Sie ist der einzige Text, den der Agent liest, wenn er entscheidet, ob er einen Skill zündet. Vage Beschreibung, Skill triggert nie.
Wie Claude Code und Codex Skills nutzen
Claude Code entdeckt Skills im Dateisystem: Ordner ins Skills-Verzeichnis legen, fertig – kein Upload-Schritt. Codex bietet zwei Aufrufmodi, explizit (/skills oder $skill-name) und implizit, wobei es anhand deiner Aufgabe automatisch auswählt. Weil beide dasselbe Ordnerlayout lesen, wandert ein gut geschriebener Skill mit wenig Anpassung zwischen ihnen.
Eine Einordnung, die sich einzuprägen lohnt: Nimm für prozedurales Wissen Skills statt MCP. Skills sind dateisystembasiert, Git-versioniert und serverlos – deutlich weniger Aufwand, als einen MCP-Server aufzusetzen. MCP gewinnt weiterhin bei Live-Daten und Systemanbindungen. Skills gewinnen bei wiederverwendbaren Workflows. Wähle das richtige Werkzeug, statt eines von beiden blind nachzubeten.
Acht Skills, die du zuerst bauen solltest
Jeder ist portabel, und jeder zeigt die SKILL.md plus die Zeile, die ihn aufruft. Fang mit den zwei oder drei an, die deiner tatsächlichen Arbeitswoche am nächsten sind.
1. Conventional-Commit-Schreiber.
---
name: commit-msg
description: Write a Conventional Commits message from the staged diff. Trigger on "write a commit message".
---
Read the staged diff. Output one line: type(scope): summary, then a short body
explaining why, not what. Types: feat, fix, chore, docs, refactor, test.
Aufruf: $commit-msg nach dem Stagen, oder „schreib eine Commit-Nachricht für diese Änderungen".
2. PR-Beschreibung aus einem Diff. Verwandelt einen Branch-Diff in eine betitelte Zusammenfassung, eine Risikoliste und eine Testplan-Checkliste. Aufruf: „öffne einen PR für diesen Branch". Der Wert liegt in einer konsistenten Vorlage, der deine Reviewer vertrauen können.
3. Test-Gerüst aus einer Signatur. Bekommt eine Funktion und schreibt den Happy Path, einen Edge Case und einen Fehlerfall – und hört dann auf, statt Verhalten zu erfinden, das er nicht sehen kann. Aufruf: „bau ein Test-Gerüst für diese Funktion".
4. Brand-Voice-Enforcer.
---
name: brand-voice
description: Rewrite a draft to match our tone rules. Trigger on "make this on-brand".
---
Apply these rules: short sentences, concrete nouns, no hype words. Keep claims
that have a number or a source; cut claims that do not. Return the edit only.
Schreib die Regeln einmal, und jeder Entwurf hält sie ein, ohne dass du dich erneut erklären musst.
5. Changelog aus Commits. Liest die Commit-Historie seit dem letzten Tag und entwirft Release Notes, gruppiert nach Added, Fixed, Changed. Aufruf: „entwirf das Changelog seit v1.2.0".
6. Screenshot zu Bug-Report. Nimmt ein Bild plus eine Ein-Zeilen-Beschwerde und produziert Reproduktionsschritte, Erwartet-vs-Tatsächlich und eine erste Fehlervermutung. Aufruf: Screenshot anhängen und sagen „leg das als Bug an".
7. Kundensupport-Makro-Responder. Klassifiziert eine eingehende Nachricht, entwirft eine Antwort in deiner Markenstimme und markiert alles, was einen Menschen braucht. Reines Markdown, kein Code nötig. Aufruf: „triagiere dieses Ticket und entwirf eine Antwort".
8. Der Meta-Skill: skill-creator. Ein Skill, der dich zu einem Workflow interviewt und den Ordner für den nächsten Skill gerüstet anlegt. So wächst die Bibliothek, ohne dass du jedes Mal von Hand YAML schreibst.
Nicht-technische Gründer starten am besten mit dem Brand-Voice-Enforcer und dem Support-Responder. Für Entwickler verdienen der Commit-Schreiber, die PR-Beschreibung und das Test-Gerüst ihren Platz noch in der Woche, in der du sie schreibst.
Sicherheits- und Review-Checkliste
Skills führen Code aus, ein schlechter ist also ein Supply-Chain-Risiko. Behandle ihn wie eine Dependency:
- Prüfe alles aus nicht vertrauenswürdigen Quellen. Lies die
SKILL.mdund jede Datei inscripts/, bevor du installierst. - Halte Anweisungen schlank. Eine überladene
SKILL.mdhebelt Progressive Disclosure aus; schieb Tiefenmaterial inreferences/. - Schreib eine scharfe
description. Sie ist der Trigger; eine schwache bedeutet, der Skill zündet still und leise nie. - Bau mit einem Eval. Starte mit einem Test dafür, wie „gut" aussieht, iteriere mit dem Agenten, dann dünn aus.
- Konstruiere auf Portabilität. Es ist ein offener Standard – die Annahmen eines einzelnen Anbieters fest zu verdrahten wirft den Hauptvorteil weg.
Behalte die Bibliothek
Sichere die Skills, die du baust, als versionierten Satz im Command Center – so wird dein Prozess zu einem Asset, das du wiederverwendest, statt zu einem Prompt, den du neu eintippst.
Quellen und weiterführende Links
- Anthropic: Equipping agents for the real world with Agent Skills
- OpenAI Codex: Agent Skills
- Anthropic: Claude Code documentation
FAQ
Überlastet ein Regal voller Skills mein Kontextfenster? Nein. Progressive Disclosure sorgt dafür, dass der Agent vorab nur Namen und Beschreibungen sieht und einen vollständigen Skill erst bei Bedarf lädt – ein ungenutzter Skill kostet dich also so gut wie nichts.
Muss ich programmieren können, um einen Skill zu schreiben?
Nein. Der einfachste Skill ist eine SKILL.md mit Frontmatter und Anweisungen in normaler Sprache. Nutze einen skill-creator oder einen Record-and-Replay-Ablauf, um aus einer von dir vorgeführten Demonstration einen Skill zu erzeugen.
Ist ein Skill dasselbe wie ein MCP-Server? Nein. Skills sind dateisystembasierte, prozedurale Workflows in Git. MCP verbindet zu Live-Systemen und -Daten. Nimm Skills für wiederholbares Anleitungswissen, MCP für Echtzeit-Verbindungen – und oft beides.
Wohin lege ich einen Skill, damit mein Agent ihn findet?
In das Skills-Verzeichnis deines Agenten als benannter Ordner mit einer SKILL.md. Claude Code und Codex finden Skills beide im Dateisystem – weshalb derselbe Ordner anbieterübergreifend funktioniert.