Die Kurzantwort
Ein Skill ist ein Ordner mit einer SKILL.md-Datei darin. Die Datei beginnt mit einem kurzen Header mit name und description, danach folgen die Anweisungen. Dein Agent behält nur Name und Beschreibung im Kopf, bis eine Anfrage passt, und liest dann den Rest. Derselbe Ordner funktioniert in Claude Code, Codex und Cursor.
Warum es Skills gibt
Das kennst du bestimmt
Du hast einen 40-zeiligen Prompt für Launch-Seiten. Er legt Layout, Abschnitte und die Prüfungen in Smartphone-Breite fest. Du fügst ihn jedes Mal ein, lässt einmal eine Zeile weg, und die Seite sieht anders aus. Dann fragt eine Kollegin nach „diesem Prompt“, und du schickst ihr die Version vom letzten Monat.
Ein Skill macht aus diesem Prompt einen Ordner, den dein Agent von selbst findet. Nimm Meridian Marketing Landing: Sobald er installiert ist, kennt der Agent schon den Hero im Millimeterpapier-Look, das Feature-Raster und den Preis-Umschalter. Du lieferst nur noch deine Produktfakten.
Die meisten Beispiele für Claude Skills folgen demselben Muster: eine feste Methode für eine Art von Ergebnis. Notion Style OG Image erstellt ein 16:9-Teilen-Bild, und andere Skills auf Skillry bauen Foliensätze, Lebenslauf-Websites und kurze Videos.
| Eingefügter Prompt | Skill | |
|---|---|---|
| Was du erklärst | Layout, Abschnitte, Stil und Prüfungen – jedes Mal | Nur deinen Inhalt |
| Von Lauf zu Lauf | Weicht jedes Mal ein bisschen ab | Folgt denselben Schritten |
| Teilen | Aus dem Chatverlauf heraussuchen | Denselben Ordner installieren |
Was steht in einer SKILL.md-Datei?
Ein Skill braucht genau eine Datei, SKILL.md, und kann optionale Ordner für Referenzdokumente, Skripte und Vorlagen mitbringen. Die Datei hat zwei Teile: einen kurzen Header zwischen ----Zeilen und danach einfache Anweisungen für den Agent.
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
Bis zu 64 Zeichen aus Kleinbuchstaben, Ziffern und Bindestrichen. Muss dem Ordnernamen entsprechen.
description
Bis zu 1.024 Zeichen. Sag, was der Skill tut und wann er gebraucht wird; anhand dieser zweiten Hälfte wählt der Agent ihn aus.
Optional
license, compatibility, metadata, allowed-tools
Diese Grenzwerte stammen aus der offenen Agent-Skills-Spezifikation. Claude Code ist großzügiger: Du kannst name weglassen, dann wird der Ordnername verwendet.
Wie entscheidet ein Agent, welchen Skill er nutzt?
Er vergleicht deine Anfrage mit der Beschreibung jedes Skills. Damit das sparsam bleibt, lädt er jeden Skill in drei Stufen:
- 1Beim Start liest er Name und Beschreibung jedes installierten Skills. Sonst nichts.
- 2Wenn deine Anfrage zu einer Beschreibung passt oder du den Skill über den Namen aufrufst, lädt er die ganze
SKILL.md. - 3Während der Arbeit öffnet er Dateien in
references/oder führtscripts/nur aus, wenn die Anweisungen es verlangen.
Deshalb kannst du Dutzende Skills installieren, ohne deinen Agent auszubremsen. Solange ein Skill nicht gebraucht wird, belegt er nur etwa einen Satz Kontext.
| Agent | Skill über den Namen aufrufen |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name oder aus /skills auswählen |
| Cursor | /skill-name oder @skill-name zum Anhängen |
Die automatische Auswahl ist nur so gut wie die Beschreibung. Auslösen zeigt, wie du eine schreibst, die gewählt wird. Bis dahin funktioniert der Aufruf über den Namen immer.
Welche Agents können Skills nutzen?
Die meisten, von denen du schon gehört hast. Anthropic hat das Format für Claude entwickelt und es am 18. Dezember 2025 als offenen Standard veröffentlicht. Die Website agentskills.io listet inzwischen Dutzende Tools, die es lesen, darunter Claude Code, ChatGPT und Codex, Cursor, VS Code, GitHub Copilot und Gemini CLI.
| Agent | Persönlicher Ordner |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ (liest auch das ältere ~/.codex/skills/) |
| Cursor | ~/.cursor/skills/ oder ~/.agents/skills/ |
Ein Skill in deinem persönlichen Ordner steht in jedem Projekt auf deinem Computer zur Verfügung. Projektordner und alle anderen Orte, an denen ein Agent sucht, findest du unter Skill-Speicherorte.
Skill oder Prompt: Was solltest du nutzen?
Mach einen Skill daraus, wenn du die Aufgabe wiederholst und jedes Mal dieselbe Qualität willst. Für etwas Einmaliges reicht ein Prompt.
Du machst das wieder
- Es braucht Beispiele, Skripte oder eine Checkliste
- Du willst jedes Mal dasselbe Ergebnis
- Andere brauchen es auch
Es ist einmalig
- Ein paar Sätze reichen
- Du findest noch heraus, was du willst
- Nichts davon lohnt sich wiederzuverwenden
Meistens nutzt du beides. Der Prompt sagt, was du heute willst, und der Skill sagt, wie man es gut macht. Skills vs. Prompts geht tiefer.
Was du vor der Installation eines Skills prüfen solltest
Ein Skill kann Skripte auf deinem Computer ausführen, also lies jeden neuen zuerst kurz durch.
Ein Fünf-Minuten-Check
- Lies
SKILL.mdund merk dir, was er ändern darf. - Lies alles in
scripts/. Diese Skripte laufen auf deinem Rechner. - Prüfe Abhängigkeiten und Externe Kosten auf der Skill-Seite.
- Halte Passwörter und API keys aus Skill-Dateien und aus dem Chat heraus.
Die vollständige Liste steht unter Sicherheit. Wenn du bereit bist, einen auszuprobieren, führt dich Erste Schritte durch deine erste Installation.
Häufige Fragen
Was sind Claude Skills?
So nennen die meisten Agent Skills, wenn sie sie in Claude oder Claude Code nutzen. Das Format ist dasselbe: ein Ordner mit einer SKILL.md-Datei. Derselbe Ordner funktioniert auch in Codex und Cursor.
Woher weiß Claude, welchen Skill es nutzen soll?
Es vergleicht deine Anfrage mit der Beschreibung jedes Skills und lädt den passenden. Mit /skill-name entfällt das Raten.
Kann ich Claude Skills kostenlos nutzen?
Ein Skill besteht nur aus Dateien, ein kostenloser kostet also nichts. Du brauchst aber einen Agent, der Skills unterstützt – etwa Claude Code, Codex oder Cursor – mit dem Plan, den das jeweilige Produkt verlangt. Auf Skillry gibt es auch kostenlose Skills, zum Beispiel Dot Avatar Maker.
Ist ein Skill dasselbe wie ein MCP-Server?
Nein. Ein Skill bringt dem Agent eine Methode bei, ein MCP-Server verbindet ihn mit externen Daten und Tools. Oft nutzt du beides zusammen. Siehe Skills vs. MCP.
Quellen
War diese Anleitung hilfreich?