Wenn du immer wieder dieselben Anweisungen in einen Chat kopierst – eine Deploy-Checkliste, einen Leitfaden für die Markenstimme, einen "Fasse zusammen, was sich geändert hat"-Prompt – dann bist du dem reinen Prompting längst entwachsen. Claude Code Agent Skills sind die Lösung. Ein Skill ist ein Ordner mit einer SKILL.md-Datei, der einen wiederverwendbaren Workflow bündelt, den Claude bei Bedarf lädt. So erledigt die KI eine wiederkehrende Aufgabe jedes Mal gleich – über Sessions hinweg und im ganzen Team. Dieser Leitfaden zeigt, was Skills sind, wie sie sich von Prompts unterscheiden, wie Claude Code und Codex sie nutzen, und liefert dir eine Copy-Paste-Bibliothek plus eine Sicherheits-Checkliste. Geschrieben für zwei Leser zugleich: die nicht-technische Gründerin, die mit KI ihre eigene Ops automatisiert, und den Entwickler, der Produktionscode shippt.
Was Claude Code Agent Skills sind
Ein Skill ist ein Verzeichnis mit einer SKILL.md-Datei. Die minimale Variante besteht aus YAML-Frontmatter mit einer description und ein paar Markdown-Anweisungen:
---
description: Summarize what changed in the working tree as 2-3 plain-English bullets and flag anything risky.
---
Run `git diff HEAD`. Summarize the changes in 2-3 bullet points a non-technical
person could follow. Call out anything that could break the app or expose secrets.
Lege das in einen Ordner, und Claude nimmt es in sein Toolkit auf. Die offizielle Doku bringt es auf den Punkt: "Skills extend what Claude can do. Create a SKILL.md file with instructions, and Claude adds it to its toolkit." Du schreibst einen Skill, "wenn du immer wieder dieselben Anweisungen, Checklisten oder mehrstufigen Abläufe in den Chat kopierst".
Skills bündeln mehr als nur Text: Vorlagen, Beispiel-Ausgaben, Referenzdokumente und ausführbare Skripte in jeder Sprache. Halte die SKILL.md selbst unter 500 Zeilen und schiebe die Details in separate Dateien – das macht den Skill günstig im Laden.
Skills leben auf vier Ebenen, die entscheiden, wer sie nutzen kann:
- Personal —
~/.claude/skills/<name>/SKILL.md, verfügbar über all deine Projekte hinweg. - Project —
.claude/skills/<name>/SKILL.md, ins Repo eingecheckt, sodass das ganze Team ihn bekommt. - Plugin —
<plugin>/skills/<name>/, über ein Plugin verteilt. - Enterprise — über die Einstellungen verwaltet.
Die Rangfolge lautet Enterprise > Personal > Project, und jede Ebene überschreibt einen mitgelieferten Skill mit demselben Namen.
Wie sich Agent Skills von Prompts unterscheiden
Ein Prompt ist etwas, das du einmal tippst und wieder verlierst. Ein Skill sind dieselben Anweisungen, gespeichert, benannt und automatisch geladen, wenn sie relevant sind. In der Praxis zählen drei Unterschiede.
Progressive Disclosure. Anthropics Engineering-Team beschreibt einen Skill als "Onboarding-Leitfaden für eine neue Mitarbeiterin". Drei Schichten laden nacheinander: (1) Name und Beschreibung des Skills sind vorgeladen, damit Claude weiß, wann es danach greifen soll; (2) die vollständige SKILL.md lädt erst, wenn die Anfrage passt; (3) gebündelte Referenzdateien laden nur, wenn sie tatsächlich gebraucht werden. Wie die Doku anmerkt: "long reference material costs almost nothing until you need it." Ein 5.000-Wörter-Prompt, in den Chat kopiert, kostet bei jedem Turn Tokens; ein Skill kostet fast nichts, bis er feuert.
Skills können Code ausführen und Dateien ausliefern. Ein Prompt produziert Text. Ein Skill kann ein Python-Skript bündeln – Anthropics Vorzeigebeispiel füllt PDF-Formulare aus, eine Aufgabe, die reine Textgenerierung nicht leisten kann.
Zwei Wege zum Auslösen, mit Kontrolle. Claude lädt einen Skill automatisch, wenn deine Anfrage zur description passt, oder du tippst direkt /skill-name. Das Frontmatter gibt dir das Lenkrad: disable-model-invocation: true bedeutet, dass nur ein Mensch ihn auslösen kann (nutze das für /deploy und /commit – du willst nicht, dass Claude entscheidet zu shippen, nur weil der Code fertig aussieht), und user-invocable: false bedeutet, dass nur Claude ihn auslöst (für Hintergrundwissen, das es konsultieren soll, das du aber nie von Hand aufrufst).
Wie Claude Code Skills nutzt
Claude Code bringt Skills ab Werk mit – /code-review, /debug, /run, /verify, /loop, /batch, /claude-api – und das Duo run/verify startet tatsächlich deine App, um zu bestätigen, dass eine Änderung gegen die laufende Anwendung funktioniert, nicht nur gegen die Test-Suite.
Im Frontmatter läuft der wiederverwendbare Workflow zusammen:
allowed-toolsgenehmigt bestimmte Tools vorab (z. B.Bash(git add *)), damit Claude mitten in der Aufgabe nicht ständig nach Erlaubnis fragt.context: forkführt den Skill in einem isolierten Subagenten aus;agent: Explorewählt den Subagent-Typ.pathsbeschränkt einen Skill auf passende Dateien;modelundeffortüberschreiben das Modell pro Skill.- Dynamische Kontext-Injektion: eine Zeile wie
!`git diff HEAD`führt den Shell-Befehl aus und fügt dessen Ausgabe inline ein, bevor Claude den Rest des Skills liest.
Ein Detail, das man kennen sollte: Custom Commands und Skills sind verschmolzen. .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erzeugen beide /deploy. Alte Command-Dateien funktionieren weiterhin – Skills ergänzen lediglich das Verzeichnis für Begleitdateien, die Frontmatter-Kontrollen und das automatische Laden obendrauf.
Du kannst auch prüfen, ob ein Skill wirklich hilft. Das Plugin skill-creator (Installation mit /plugin install skill-creator@claude-plugins-official) fährt A/B-Evals: Es speichert Testfälle, spawnt pro Fall einen Subagenten, bewertet die Ausgabe und benchmarkt mit-Skill gegen ohne-Skill bei Trefferquote, Tokens und Zeit. Das hält dich davon ab, "der Skill hat ausgelöst" mit "der Skill hat geholfen" zu verwechseln.
Wie Codex Skills nutzt
Skills sind längst keine reine Anthropic-Idee mehr – das Format wird zum portablen Standard. Es ist als offener Standard auf agentskills.io veröffentlicht (erschienen am 18. Dezember 2025), und dieselbe SKILL.md funktioniert über Claude.ai, Claude Code, das Claude Agent SDK und die Claude Developer Platform hinweg.
OpenAI Codex hat im Dezember 2025 dasselbe SKILL.md-Verzeichnisformat übernommen. Sein herausragendes Feature ist Record-and-Replay: Codex schaut dir einmal beim Ausführen eines Workflows zu und entwirft dann den Skill für dich – praktisch, wenn du einen Prozess lieber vormachst, als ihn auszuformulieren. Codex bringt zudem einen eigenen $skill-creator mit und läuft über seine CLI (Open Source, in Rust geschrieben), eine IDE-Erweiterung und in der Cloud mit Subagenten.
Ein drittes Beispiel rundet den Trend ab: Hermes Agent von Nous Research (Open Source, MIT-lizenziert – der KI-Agent, nicht das Modehaus) bezeichnet sich als "der Agent, der mit dir wächst". Er "lernt deine Projekte, generiert automatisch Skills und vergisst nie, wie er ein Problem gelöst hat", mit persistentem Gedächtnis und isolierten Subagenten. Die Lehre daraus: SKILL.md konvergiert zu einem werkzeugübergreifenden Standard – ein Workflow, den du heute kodierst, reist mit dir.
Eine Beispiel-Skill-Bibliothek
Vier Skills, die das Klauen wert sind, jeder aus Primärquellen gezogen:
summarize-changes— injiziert den livegit diff HEADund lässt Claude dann 2-3 verständliche Stichpunkte produzieren und Risiken markieren. Eine nicht-technische Gründerin fragt "Was habe ich geändert?" und bekommt ein lesbares Review, ohne git zu lernen. Das ist das erste Tutorial der Doku selbst.fill-pdf— bündelt ein Python-Skript, damit Claude PDF-Formulare ausfüllt (Verträge, Anträge, Aufnahmeformulare). Anthropics Vorzeigebeispiel und der klarste Beweis, dass ein Skill etwas kann, was ein Chat-Prompt nicht kann.deploy— setzedisable-model-invocation: true, damit die Sequenz Test-Suite → Build → Push → Verify nur läuft, wenn ein Mensch/deploytippt. Dein Release-Runbook, kodiert, mit einer KI, die nicht aus eigener Initiative shippen kann.visualize-codebase— bündelt ein Python-Skript, das einen interaktiven HTML-Baum des Repos erzeugt. "Visualisiere diese Codebasis" produziert eine durchklickbare Karte – nützlich, wenn ein Gründer fremden Code erbt.
Business-Anwendungsfälle: mit KI ein Business starten ohne Code
Du musst keinen Code schreiben, um hier Wert zu schöpfen. "Vibe Coding" – inzwischen ein im Duden-Sinne anerkannter Begriff für das Bauen von Apps, indem man einer KI sagt, was man will – beschreibt genau dieses Publikum. Skills verwandeln deine wiederholten Ad-hoc-Prompts in einen verlässlichen /command und kodieren das "So machen wir das hier", damit die KI über Sessions und Teammitglieder hinweg konsistent bleibt. Genau diese Bausteine machen aus einer Idee eine kleine KI-Automatisierungsagentur im Eigenbetrieb.
Gründer-Skills, die sich zu bauen lohnen:
- Markenstimme (
user-invocable: false) — dein Ton, verbotene Phrasen und Positionierung, automatisch geladen, wann immer Claude kundenseitigen Text schreibt. Ein Münchner SaaS-Team kann hier zum Beispiel die Du-Ansprache und seine Compliance-No-Gos festschreiben. - Wöchentliches Investoren-Update — eine Vorlage plus die zu ziehenden Kennzahlen, damit der Entwurf jede Woche konsistent ist.
- Kunden-Aufnahme / Vertrags-PDF — das
fill-pdf-Muster, angewandt auf die Formulare, die deine Ops wirklich anfasst (etwa eine AVV nach DSGVO oder ein Onboarding-Formular). - Release Notes aus Diffs —
summarize-changes, umgemünzt darauf, ein Changelog zu erzeugen, das deine Kunden lesen können.
Das Prinzip: Wenn ein Abschnitt deiner CLAUDE.md von einer Tatsache zu einer mehrstufigen Prozedur anwächst, verlagere ihn in einen Skill, damit er bei Bedarf lädt, statt jede Konversation zu besteuern.
Anwendungsfälle für Entwickler: KI-Agenten und KI-Programmierung im Alltag
- Code Review mit euren Hausregeln — erweitere
/code-reviewum die Muster, die dein Team tatsächlich durchsetzt. - Release per Befehl — das
/deploy-Runbook von oben, mitallowed-tools, das die sicheren git-Schritte vorab genehmigt. - Isolierte Untersuchungen —
context: forkplusagent: Explore, um einen Bug in einem Subagenten zu recherchieren, ohne deinen Hauptkontext zu verschmutzen. - Pfad-gebundene Konventionen —
paths, damit ein Migrations-Skill nur innerhalb deines Migrations-Verzeichnisses aktiv wird. - Eval-getriebene Iteration —
skill-creator, um zu bestätigen, dass ein Skill die Trefferquote wirklich bewegt, bevor du ihn ins Repo einsteckst.
Sicherheits- und Review-Checkliste
Skills laufen mit echten Tools, also prüfe sie wie Code:
- Auditiere Projekt-Skills, bevor du einem Workspace traust. Ein eingecheckter Skill kann sich selbst breite
allowed-toolseinräumen. Prüfe ihn, bevor du den Workspace-Trust-Dialog akzeptierst. - Sichere Seiteneffekte ab. Alles, was deployt, Slack sendet oder Geld bewegt, bekommt
disable-model-invocation: true. - Schreibe die
descriptionfürs Auslösen. Eine schwache Beschreibung bedeutet, dass der Skill nie feuert. Verwende die Worte, die Leute tatsächlich sagen, und prüfe mit "Welche Skills sind verfügbar?" oder/doctor. - Halte die
SKILL.mdschlank. Einmal aufgerufen, bleibt ihr Inhalt die ganze Session im Kontext und wird nicht erneut gelesen – Aufgeblähtes ist ein wiederkehrender Token-Kostenfaktor. Schiebe Details in Begleitdateien. - Behalte das Skill-Budget im Blick. Beschreibungen sind gedeckelt (je 1.536 Zeichen; der ganze Satz budgetiert auf rund 1 % des Kontextfensters). Zu viele ausschweifende Skills werden abgeschnitten und die am seltensten genutzten fallen weg. Platz zurückgewinnen kannst du mit
skillOverrides: "name-only". - Verwechsle "ausgelöst" nicht mit "funktioniert". Fahre Baseline-A/B-Evals mit
skill-creator.
FAQ
Muss ich programmieren können, um Claude Code Skills zu nutzen? Nein. Ein Skill ist eine Markdown-Datei mit Anweisungen in normaler Sprache. Gründer nutzen sie, um Texte, Reports und das Ausfüllen von Formularen zu standardisieren. Komplexität kommt erst ins Spiel, wenn du Skripte bündelst – und dafür kannst du dich auf die offiziellen Open-Source-Skills stützen.
Was ist der Unterschied zwischen einem Skill und einem Custom Command?
Sie sind verschmolzen. .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erzeugen beide /deploy, und alte Command-Dateien funktionieren weiterhin. Skills ergänzen ein Verzeichnis für Begleitdateien, Frontmatter-Kontrollen und das automatische Laden.
Führt Claude meine Skills aus, ohne zu fragen?
Nur wenn du es zulässt. Claude lädt einen Skill automatisch, wenn deine Anfrage zur description passt. Setze disable-model-invocation: true, um einen Menschen zu verpflichten, den Befehl zu tippen – essenziell für Deploy, Commit oder alles, was sendet oder Geld ausgibt.
Funktionieren Claude Code Skills auch in anderen KI-Tools?
Zunehmend ja. SKILL.md ist ein offener Standard (agentskills.io, Dezember 2025). OpenAI Codex nutzt dasselbe Format mit einem Record-and-Replay-Modus, und der Hermes Agent von Nous Research generiert Skills in derselben Form automatisch.
Wie unterscheidet sich ein Skill davon, einfach die CLAUDE.md zu bearbeiten?
CLAUDE.md ist Always-on-Kontext – jede Tatsache darin kostet bei jedem Turn Tokens. Ein Skill lädt nur, wenn seine Beschreibung passt, und ist damit der richtige Ort für eine mehrstufige Prozedur, die du nicht in jeder Konversation brauchst.
Weiterlesen auf Boostor: Slash-Befehle und Skills in Claude Code: Hör auf, dieselben Prompts immer wieder einzutippen · KI-Agenten fürs Business: 25 Workflows, die du diese Woche startest · Das Vibe-Coding-Playbook für nicht-technische Gründer