Agent Skills erklärt: Wiederverwendbare KI-Workflows mit Claude Code und Codex

Wenn du schon einmal zum hundertsten Mal denselben Styleguide, dieselbe Deploy-Checkliste oder dieselbe „So will ich das gemacht haben"-Anweisung in ChatGPT oder Claude kopiert hast, dann sind Agent Skills die Lösung. Ein Agent Skill ist ein strukturierter Ordner aus Anweisungen, Skripten und Ressourcen, den ein KI-Agent eigenständig finden und laden kann, um eine bestimmte Aufgabe besser zu erledigen. Du schreibst den Workflow einmal – der Agent verwendet ihn wieder, sobald er relevant ist. Gerade wer mit KI ein Business starten will, gewinnt damit enorm: Dieser Guide zeigt, was Agent Skills sind, wie sie sich von Prompts unterscheiden, wie Claude Code und Codex sie nutzen und wie du dir eine kleine Bibliothek baust, die sich schon in einer Woche auszahlt – egal ob du nicht-technische:r Gründer:in oder erfahrene:r Entwickler:in bist.

Was Agent Skills sind

Die Definition von Anthropic bringt es auf den Punkt: Agent Skills sind „strukturierte Ordner aus Anweisungen, Skripten und Ressourcen, die Agenten dynamisch finden und laden können". Im Minimum ist ein Skill ein einziges Verzeichnis mit einer einzigen Datei: SKILL.md.

Diese Datei ist schlichtes Markdown mit einem kurzen YAML-Header. Der Header verlangt genau zwei Felder – name und description – und der Markdown-Body enthält den eigentlichen Workflow:

---
name: pdf-form-filler
description: Fill out PDF forms when a user uploads a fillable PDF and asks to complete it. Do NOT use for scanned image PDFs.
---

1. Read the uploaded PDF and list every form field.
2. Map the user's answers to those fields.
3. Write the filled PDF and return it.

Die description-Zeile leistet die Hauptarbeit. Ein Agent entscheidet anhand dieser Beschreibung, ob er einen Skill lädt, indem er die anstehende Aufgabe damit abgleicht. Die Beschreibung muss also klar sagen, wann der Skill greifen soll – und wann nicht. Eine schwammige Beschreibung ist der mit Abstand häufigste Grund, warum ein Skill nie auslöst oder im falschen Moment zündet.

Skills tragen mehr als nur Fließtext. Ein Skill-Ordner kann scripts/, references/ und assets/ bündeln. Anthropics Standardbeispiel ist ein PDF-Skill, der ein Python-Skript mitliefert, das ein Formular ausliest und seine Felder extrahiert. Der Agent führt das Skript über bash aus und bekommt nur die Ausgabe zurück – der Quellcode des Skripts landet nie im Kontextfenster. Genau das ist der wahre Unterschied zwischen einem Skill und kopierten Anweisungen: Ein Skill verpackt funktionierendes Werkzeug, nicht nur Text.

Wie sich Skills von Prompts unterscheiden (und vom Gedächtnis)

Ein Prompt ist eine einmalige Anweisung, die du tippst und immer wieder neu tippst. Ein Skill ist eine wiederverwendbare, versionierte Prozedur, die der Agent von selbst hereinholt, wenn der Moment es verlangt. Günstig wird das durch progressive Disclosure – drei Ebenen des verzögerten Ladens:

1. Ebene 1, Start. Der Agent lädt nur name und description jedes Skills. Das ist winzig, deshalb kostet eine große Bibliothek so gut wie nichts. (Codex begrenzt Skill-Beschreibungen auf rund 2 % des Kontextfensters.)
2. Ebene 2, relevant. Hält der Agent einen Skill für relevant, liest er den vollständigen SKILL.md-Body.
3. Ebene 3, bei Bedarf. Verlinkte Referenzdateien – ein Schema, eine reference.md – laden nur, wenn die Aufgabe sie tatsächlich erreicht.

Eine Aussage von Anthropic folgt direkt aus diesem Design: Weil Details erst beim Gebrauch geladen werden, ist „die Menge an Kontext, die in einen Skill gebündelt werden kann, praktisch unbegrenzt". Ein Skill, den du in einer Session nie auslöst, kostet dich quasi nichts.

Hier der Unterschied, den die meisten verwechseln: Skills sind kein Gedächtnis. Die Doku des Hermes Agent formuliert es sauber – „Memory speichert kleine, dauerhafte Fakten, die immer im Kontext sein sollten, während Skills längere Prozeduren speichern, die nur bei Relevanz laden sollten." Der eingetragene Firmenname deines Unternehmens ist ein Fakt (Memory oder eine CLAUDE.md-Zeile). Dein siebenstufiger Release-Prozess ist eine Prozedur (ein Skill). Halte die beiden auseinander.

Wie Skills in Claude Code funktionieren

In Claude Code wurden benutzerdefinierte Slash-Commands in Skills überführt, sodass beide jetzt auf derselben Mechanik laufen. Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide einen /deploy-Befehl.

Wo du den Ordner ablegst, bestimmt seinen Geltungsbereich:

• Persönliche Skills: ~/.claude/skills/ – in jedem Projekt verfügbar, nur für dich.
• Projekt-Skills: .claude/skills/ – ins Git committet und mit dem ganzen Team geteilt.

Du kannst einen Claude-Code-Skill direkt mit /skill-name aufrufen oder Claude ihn automatisch auslösen lassen, indem die Aufgabe zur Beschreibung passt. Claude Code folgt dem offenen Agent-Skills-Standard und erweitert ihn um Aufrufsteuerung, Subagent-Ausführung und dynamische Kontextinjektion. Anthropic pflegt unter github.com/anthropics/skills einen öffentlichen Katalog echter Beispiele, falls du funktionierende SKILL.md-Dateien zum Studieren suchst.

Wie Skills in Codex funktionieren

OpenAIs Codex hat Ende 2025 Skills bekommen; Simon Willison dokumentierte am 12. Dezember 2025, wie sie sowohl im Codex CLI als auch in ChatGPT auftauchten. In Codex rufst du einen Skill explizit mit $skill-name auf oder lässt Codex selbst einen passenden Skill finden.

Codex durchsucht mehrere Orte in Prioritätsreihenfolge – grob: zuerst .agents/skills im aktuellen Verzeichnis, dann .agents/skills im Repo-Root, dann dein nutzerweites $HOME/.agents/skills, dann ein Admin-Pfad, dann die Built-ins. Ein ehrlicher Hinweis: Die Pfadkonvention ist noch nicht endgültig. Frühe Codex-Versionen nutzten ~/.codex/skills; die aktuelle Doku verweist auf .agents/skills. Prüfe die Live-Doku von Codex (developers.openai.com/codex/skills) für den exakten Pfad, bevor du Ordner festschreibst.

Die Schlagzeile für alle, die bauen: Claude-Code-Skills und Codex-Skills zielen auf denselben offenen Standard (agentskills.io). Ein Skill ist, in Willisons Worten, „einfach ein Ordner mit einer Markdown-Datei und ein paar optionalen Zusatzressourcen" – also teilbar, versionierbar und über Tools und Teammitglieder hinweg wiederverwendbar, statt an einen Anbieter gebunden. Sei bei der Grenze aber präzise. Die beiden Implementierungen sind nah beieinander, doch jedes Tool fügt eigene Erweiterungen hinzu. Behandle Skills als weitgehend portabel auf einem gemeinsamen Standard, nicht als garantiert byte-für-byte austauschbare Drop-ins.

Eine Beispiel-Skill-Bibliothek

Hier eine Starter-Bibliothek, die sich schnell bezahlt macht. Jeder Punkt ist ein Ordner mit einer SKILL.md.

• brand-voice – hält deinen Tonfall, verbotene Wörter und Slogan-Regeln ein einziges Mal fest. Jede Landingpage, E-Mail oder jeder Tweet-Entwurf kommt markenkonform heraus, ohne dass du den Styleguide neu reinkopierst. Das ist das Versprechen „Vorlieben einmal definieren, automatisch wiederverwenden" – konkret gemacht.
• pdf-form-filler – Anthropics eigenes Beispiel: Wirf einen Lieferantenvertrag oder eine Rechnung hinein, und der Agent füllt über ein mitgeliefertes Skript jedes Feld aus. Du siehst ein fertiges Dokument, nie Code.
• deploy – committe .claude/skills/deploy/SKILL.md ins Repo, und jede:r im Team (oder die KI selbst) führt mit /deploy dieselbe Release-Checkliste aus. Aus Insiderwissen wird ein geteilter, versionierter Workflow.
• weekly-report – zieht deine Standard-Kennzahlen, formatiert sie nach deinem Geschmack, jeden Montag, jedes Mal gleich.

Business-Anwendungsfälle für nicht-technische Gründer:innen

Du musst keinen Code lesen, um hier Mehrwert zu ziehen. Skills sind der Punkt, an dem Vibe Coding – der Begriff für Software-Bauen, indem man beschreibt, was man will, und die KI es produzieren lässt – erwachsen wird. Statt denselben Workflow jede Session neu zu beschreiben, kodierst du ihn einmal, damit der Agent ihn zuverlässig ausführt:

• Markenkonformer Content in Serie. Ein brand-voice-Skill hält jedes KI-geschriebene Asset konsistent, sodass du nicht mehr der Flaschenhals bist, der jeden Tonfall prüft. Eine Münchner SaaS-Gründerin etwa kann so eine deutsch-englische Markenstimme einmal festhalten und nie wieder erklären.
• Wiederholbare Abläufe. Onboarding-Mails, Investor-Updates, Support-Makros – alles, was du jedes Mal gleich machst, wird zu einem Skill, den das ganze Team (und der Agent) identisch ausführt.
• Das Know-how externer Dienstleister zum Asset machen. Wenn eine KI-Automatisierungsagentur oder ein:e Freelancer:in einen Prozess als Skill dokumentiert, bleibt dieses Wissen im Repo – auch nachdem das Mandat endet.

Anwendungsfälle für Entwickler:innen

Für alle, die bauen, sitzen Skills direkt im Codebase:

• Codebase-Konventionen auf Abruf. Ein Skill, der dein Test-Muster, dein Commit-Message-Format oder deine Migrationsschritte kodiert, sorgt dafür, dass der Agent den Hausstil ohne erneutes Prompten befolgt.
• Gebündeltes Werkzeug. Liefere einen scripts/-Ordner mit, damit der Agent echten Code ausführt – einen Linter, einen Generator, einen Daten-Check – und nur die Ausgabe liest. So bleibt das Kontextfenster sauber.
• Selbstverbessernde KI-Agenten. Der Hermes Agent von Nous Research (Open Source, MIT, erschienen 2026) schreibt seine eigenen Skills über ein skill_manage-Tool und behandelt sie als „prozedurales Gedächtnis". Wenn er einen nicht-trivialen Workflow herausarbeitet oder von einem Nutzer korrigiert wird, sichert er den Ansatz als wiederverwendbaren Skill. (Nenne ihn „Hermes Agent" oder „Nous Hermes", um Verwechslungen mit der Luxusmarke zu vermeiden.) Es ist ein Vorgeschmack auf KI-Agenten, die Workflows selbstständig lernen und wiederverwenden.

Sicherheits- und Review-Checkliste

Skills machen Arbeit wiederholbar, nicht unfehlbar. Googles People-First-Leitlinien belohnen weiterhin echte Erfahrung und menschliches Urteilsvermögen – und das solltest du auch. Bevor du einem Skill vertraust:

1. Schärfe die description. Sag, wann er auslöst und wann er es keinesfalls darf. Stell die Trigger-Wörter nach vorne, damit der Agent ihn korrekt auswählt.
2. Halte SKILL.md schlank. Anthropics Faustregel: unter 500 Zeilen. Schiebe Details in verlinkte Referenzdateien, damit progressive Disclosure funktioniert – stopf nicht alles in eine riesige Datei.
3. Trenne Skills von Fakten. Dauerhafte Fakten gehören ins Gedächtnis oder in CLAUDE.md; mehrstufige Prozeduren in einen Skill, der bei Bedarf lädt.
4. Prüfe gebündelte Skripte. Jeder Code, den ein Skill ausführt, verdient dieselbe Sorgfalt wie Code, den du selbst geschrieben hast.
5. Setze kein Cross-Tool-Drop-in voraus. Gleicher Standard, aber verifiziere, dass sich ein Claude-Code-Skill in Codex wie erwartet verhält – und umgekehrt –, statt identische Ausführung anzunehmen.
6. Schreibe keine veralteten Pfade fest. Konventionen verschieben sich noch (Codex ~/.codex/skills → .agents/skills); verweise auf die aktuelle Doku.
7. Behalte einen Menschen in der Schleife. Skills nehmen dir die Wiederholung ab, nicht die Verantwortung.

FAQ

Brauche ich Programmierkenntnisse, um Agent Skills zu nutzen? Nein. Eine SKILL.md ist schlichtes Markdown – Anweisungen in Worten. Du kannst einen nützlichen brand-voice- oder weekly-report-Skill schreiben, ohne Code anzufassen. Skripte sind optional und werden meist von einer Entwicklerin oder einem Entwickler ergänzt.

Funktioniert ein Skill, den ich für Claude Code schreibe, auch in Codex? Weitgehend. Beide zielen auf denselben offenen Agent-Skills-Standard, der Kern ist also portabel. Aber jedes Tool fügt Erweiterungen hinzu, also teste ihn im zweiten Tool, statt eine byte-für-byte identische Ausführung anzunehmen.

Was ist der Unterschied zwischen einem Skill und Memory? Memory hält kleine, dauerhafte Fakten, die immer im Kontext sein sollten, etwa deinen Produktnamen. Ein Skill hält eine längere Prozedur, die nur bei Relevanz lädt, etwa deine Deploy-Checkliste. Fakten bleiben an; Skills laden bei Bedarf.

Wie unterscheidet sich das davon, einfach einen richtig guten Prompt zu schreiben? Ein Prompt ist einmalig und manuell. Ein Skill ist gespeichert, versioniert, wird vom Agenten automatisch gefunden und kann Skripte und Referenzdateien bündeln – sodass derselbe Workflow zuverlässig in jeder Session läuft, ohne dass du ihn neu tippst.

---

Mehr auf Boostor: Claude-Code-Skills bauen, KI-Agenten fürs Business entwerfen und eine Einführung in Vibe Coding für nicht-technische Gründer:innen.