---
title: "Claude Skills erklärt: Wie Agent Skills wirklich funktionieren"
description: "Claude Skills sind Ordner mit einer SKILL.md, die Claude nur bei Bedarf lädt. Was sie sind, wo sie laufen und welche sich wirklich lohnen."
type: "guide"
locale: "de-CH"
category: "Claude Code"
canonical: "https://agenticschool.dev/de/ratgeber/claude-skills-explained"
datePublished: "2026-08-28"
dateModified: "2026-08-28"
---

# Claude Skills erklärt: Wie Agent Skills wirklich funktionieren

- Kategorie: Claude Code
- Keywords: claude skills, claude code skills, what are claude skills, claude agent skills, claude skills marketplace, how to use claude skills, claude skills vs subagents, best claude skills, how to add skills to claude code, claude skills example, claude skills github, claude design skills
- Kanonische URL: https://agenticschool.dev/de/ratgeber/claude-skills-explained
- Sprache: de-CH

> Claude Skills sind Ordner mit einer SKILL.md, die Claude nur bei Bedarf lädt. Was sie sind, wo sie laufen und welche sich wirklich lohnen.

Claude Skills sind Ordner. Jeder enthält eine SKILL.md, deren YAML frontmatter zwei Pflichtfelder trägt, name und description, gefolgt von Markdown-Anweisungen, und der Agent lädt diesen Inhalt nur, wenn deine Anfrage zur description passt. Anthropic nennt die Funktion Agent Skills, hat sie im Dezember 2025 als offenen Standard veröffentlicht und unterstützt sie in claude.ai, Claude Code, dem Claude Agent SDK und der Claude Developer Platform. Dieser Claude Skills Guide zeigt dir, was ein Claude Skill ist, wo Skills laufen, wie sie sich von slash commands, Subagents, MCP-Servern und CLAUDE.md unterscheiden, welche sich zu installieren lohnen und wie du in rund zehn Minuten selbst einen schreibst.

## Was ein Claude Skill ist, in drei Ebenen

Ein Claude Skill ist ein Verzeichnis mit einer SKILL.md darin, optional daneben Scripts, Referenzdokumente und Templates. Die Datei beginnt mit YAML frontmatter und geht als ganz normale Markdown-Anweisung weiter. Was das Format funktionieren lässt, ist nicht die Datei, es ist das Lademodell: Anthropic dokumentiert einen dreistufigen Prozess namens progressive disclosure, bei dem der Agent beim Start nur die Metadaten liest, die Anweisungen erst in den Context zieht, wenn deine Anfrage passt, und die mitgelieferten Dateien nur anfasst, wenn die Aufgabe sie wirklich braucht. Deshalb kannst du viele Skills installieren, ohne für die zu zahlen, die du nie auslöst.

- Ebene 1, Metadaten: die Felder name und description, beim Start in den System Prompt geladen, rund 100 Tokens pro Skill.
- Ebene 2, Anweisungen: der Body der SKILL.md, nur beim Auslösen geladen, empfohlen unter 5.000 Tokens.
- Ebene 3, Ressourcen: mitgelieferte Referenzdateien und Scripts, die nichts kosten, bis sie gelesen werden. Ein Script, das läuft, steuert nur seine Ausgabe bei, nie seinen Quelltext.

Die description ist keine Dokumentation, sie ist die Matching-Fläche. Sie ist der einzige Text über deinen Skill, der im System Prompt steht, bevor irgendetwas ausgelöst wird, also das Einzige, was deinen von allen anderen Skills trennt, die Claude sieht. Anthropic verlangt, dass sie sowohl sagt, was der Skill macht, als auch, wann er einzusetzen ist, und eine vage description ergibt einen Skill, der nie feuert.

Alles auf dieser Seite wurde am 28. August 2026 aus Primärquellen gelesen: der Agent Skills Overview auf der Claude Developer Platform, die Claude Code Skills Reference, die veröffentlichte Agent Skills Spezifikation und das Repository anthropics/skills auf GitHub. Skills sind im Oktober 2025 erschienen und die Oberfläche bewegt sich noch schnell, prüfe also dieselben Quellen, bevor du etwas Teures auf ein einzelnes Detail hier baust.

## Wo Claude Skills funktionieren, Oberfläche für Oberfläche

Skills laufen in Claude Code, in claude.ai und über die Claude API, und Anthropic gibt an, dass auch das Claude Agent SDK und die Claude Developer Platform sie unterstützen. Was sich zwischen den Oberflächen ändert, ist, wo die Datei liegt, wer sie sonst noch sieht und welche frontmatter-Felder erlaubt sind. Die Warnung, über die alle stolpern: eigene Skills synchronisieren nicht zwischen den Oberflächen. Ein Skill, den du auf claude.ai hochlädst, ist über die API nicht verfügbar, und Claude Code Skills liegen im Dateisystem und sind von beidem getrennt. Du installierst denselben Ordner einmal pro Oberfläche, auf der du ihn haben willst.

- Claude Code, wo er liegt: ~/.claude/skills/name/SKILL.md für persönliche Skills, .claude/skills/name/SKILL.md für ein Projekt, oder ein skills-Ordner in einem Plugin.
- Claude Code, wer ihn nutzen kann: du, alle die das Repo klonen, oder alle für die das Plugin aktiviert ist. Der Verzeichnisname wird zum slash command.
- Claude Code, erlaubte frontmatter: alle Felder, inklusive der Claude Code Erweiterungen wie disable-model-invocation, allowed-tools, model, effort und paths.
- Claude Code, aufpassen bei: Skills haben denselben Netzwerkzugriff wie jedes andere Programm auf deinem Rechner, ein nicht vertrauenswürdiger Skill ist also nicht vertrauenswürdige Software.

- claude.ai, wo er liegt: als ZIP-Datei über Settings und dann Features hochgeladen.
- claude.ai, wer ihn nutzen kann: nur du. Anthropic gibt an, dass eigene Skills dort individuell pro Nutzer sind und von Admins nicht zentral verwaltet werden können. Pro, Max, Team und Enterprise Pläne, code execution eingeschaltet.
- claude.ai, erlaubte frontmatter: nur die sechs Felder der Spezifikation, also name, description, license, compatibility, metadata und allowed-tools.
- claude.ai, aufpassen bei: der Netzwerkzugriff hängt von deinen Nutzer- und Admin-Einstellungen ab, ein Skill der Daten holt, kann sich also anders verhalten als auf deinem Rechner.

- Claude API, wo er liegt: über die /v1/skills Endpoints erstellt und per skill_id im container-Parameter einer Anfrage referenziert.
- Claude API, wer ihn nutzen kann: der ganze Workspace. Anthropic gibt an, dass hochgeladene eigene Skills workspace-weit geteilt werden.
- Claude API, erlaubte frontmatter: dieselben sechs Spezifikationsfelder wie bei claude.ai. Ein unerwarteter Key lässt den Upload mit einem harten Fehler scheitern, statt still ignoriert zu werden.
- Claude API, aufpassen bei: Skills brauchen das code execution Tool und laufen in einem Sandbox-Container ohne Netzwerkzugriff und ohne Paketinstallation zur Laufzeit, verfügbar sind also nur vorinstallierte Pakete.

Anthropic liefert ausserdem vier vorgebaute Agent Skills für Dokumente: PowerPoint, Excel, Word und PDF, referenziert über die skill ids pptx, xlsx, docx und pdf. Die sind auf claude.ai aktiv und über die API verfügbar, und Anthropic gibt an, dass sie in Claude Code nicht verfügbar sind, während dort stattdessen der Open-Source-Skill claude-api mitgeliefert wird.

## Claude Skills vs Agents, Subagents, Commands und MCP

Das sind keine konkurrierenden Optionen, sie lösen verschiedene Probleme, und sie zu verwechseln ist der häufigste Fehler in diesem ganzen Bereich. Claude Skills vs Agents ist schon die falsche Gegenüberstellung: ein Agent ist das ganze System, das die Arbeit macht, und ein Skill ist eines der Dinge, die du ihm gibst, keine kleinere Version davon. Ein Skill ist eine Prozedur, die bei Bedarf geladen wird. Ein slash command ist inzwischen dasselbe in einer einzigen Datei, weil Anthropic Custom Commands in Skills zusammengeführt hat: eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide /deploy und verhalten sich identisch, und wenn es beide gibt, gewinnt der Skill. Ein Subagent ist ein eigener Context, der Arbeit erledigt und ein Ergebnis zurückmeldet. Ein MCP Server ist eine lebende Verbindung zu einem externen System. CLAUDE.md ist ein Satz Fakten, der in jeder einzelnen Runde geladen wird.

- Skill: nimm ihn, wenn du dieselbe mehrstufige Prozedur immer wieder einfügst und sie verfügbar haben willst, ohne sie in jeder Runde zu laden.
- Slash command: nimm ihn, wenn eine Markdown-Datei reicht und es nichts zu bündeln gibt. Er erzeugt denselben Command wie ein Skill, es gibt also keinen Grund, einen funktionierenden zu migrieren.
- Subagent: nimm ihn, wenn die Arbeit deinen Haupt-Context fluten würde und du nur das Ergebnis zurück brauchst.
- MCP Server: nimm ihn, wenn der Agent zur Laufzeit Live-Daten oder eine externe API braucht. Anweisungen können nichts abrufen.
- CLAUDE.md: nimm sie für Fakten, die in jeder Runde gelten. Anthropic rät, einen CLAUDE.md-Abschnitt in einen Skill zu verschieben, sobald er von einem Fakt zu einer Prozedur gewachsen ist.

Diese Aufteilung richtig hinzubekommen, macht den grössten Teil des Unterschieds zwischen einem Agent-Setup, das sich schnell anfühlt, und einem, das sich aufgebläht anfühlt, und sie ist das Rückgrat des Claude Code Kurses, den wir an der Agentic School unterrichten.

## Der Aufbau einer minimalen SKILL.md

Ein funktionierender Skill braucht genau zwei frontmatter-Felder. Die Agent Skills Spezifikation verlangt name, höchstens 64 Zeichen aus Kleinbuchstaben, Zahlen und Bindestrichen, ohne führende, abschliessende oder aufeinanderfolgende Bindestriche, und passend zum Namen des übergeordneten Verzeichnisses. Sie verlangt description, höchstens 1.024 Zeichen, die sowohl sagt, was der Skill macht, als auch, wann er einzusetzen ist. Alles andere ist optional. Das Beispiel unten ist die kürzeste ehrliche Antwort darauf, wie du Claude Skills erstellst, die überall laufen: es nutzt nur Spezifikationsfelder, derselbe Ordner lädt also in Claude Code, lässt sich auf claude.ai hochladen und für die Skills API paketieren, ohne eine einzige Änderung.

```markdown
---
name: pr-description
description: Writes a pull request description from the current branch diff. Use when the user asks for a PR description, a pull request summary, or release notes for a branch.
---

# PR description

## Steps

1. Read the diff between the current branch and the default branch.
2. Group the changes by area: features, fixes, refactors, tests.
3. Write a title under 70 characters, then a body with a Summary section and a Testing section.
4. List any migration or config change a reviewer has to apply by hand.

## Rules

- Describe behavior a reviewer can check, not the files you touched.
- Never claim a test passed unless you ran it.
- If the diff is empty, say so and stop.
```
Eine vollständige SKILL.md, gespeichert unter .claude/skills/pr-description/SKILL.md. Der Verzeichnisname wird zu /pr-description, und die description ist das, wogegen das Modell deine Anfrage matcht.

- license: die Lizenz, die für den Skill gilt, entweder ein Lizenzname oder der Name einer mitgelieferten Lizenzdatei.
- compatibility: bis zu 500 Zeichen, die Anforderungen an die Umgebung beschreiben, etwa nötige Systempakete oder Netzwerkzugriff.
- metadata: eine freie Map von String-Keys auf String-Werte, die dein eigenes Tooling lesen kann.
- allowed-tools: vorab freigegebene Tools, die der Skill nutzen darf, in der Spezifikation als experimentell markiert, weil die Unterstützung zwischen Agents variiert.

Claude Code akzeptiert weit mehr Felder als diese sechs, darunter argument-hint, arguments, disable-model-invocation, user-invocable, model, effort, context, hooks und paths. Das sind Claude Code Erweiterungen, nicht Teil des Standards. Packst du eines davon in einen Skill, den du für claude.ai oder die Skills API paketierst, scheitert der Upload mit einem Unexpected-Key-Fehler, der das Feld benennt, statt es still zu ignorieren. Schreib die portablen sechs, wenn der Skill reisen soll, und greif zu den Erweiterungen nur bei Skills, die auf deinem Rechner bleiben.

## Claude Skills Marketplace, Library und Awesome-Listen

Es gibt keinen dedizierten Claude Skills Marketplace und keine offizielle Claude Skills Library als eigenes Anthropic-Produkt. Wer danach sucht, landet stattdessen beim Claude Code Plugin-System, und das ist der eigentliche Verteilweg. Anthropic veröffentlicht sein eigenes Claude Skills Repository auf GitHub als anthropics/skills, das du in Claude Code als plugin marketplace registrierst und dann als eines von zwei Plugins installierst. Anthropic betreibt ausserdem einen offiziellen plugin marketplace, und seine Dokumentation sagt, das sei der einzige Marketplace, den Claude Code von sich aus registriert. Alles andere, auch die Awesome-Claude-Skills-Listen, die Leute teilen, ist von der Community kuratiert und ungeprüft.

- Anthropic Skills Repository: füge anthropics/skills in Claude Code als plugin marketplace hinzu und installiere dann dessen Plugin document-skills oder example-skills. Einschränkung: Anthropic bezeichnet das als Demonstrationsmaterial, nicht als Produktionscode.
- Offizieller Anthropic plugin marketplace: anthropics/claude-plugins-official, der einzige Marketplace, den Claude Code von selbst registriert. Einschränkung: Namen wie agent-skills sind genau deshalb reserviert, weil Identitätsmissbrauch hier ein reales Risiko ist.
- claude.ai Einstellungen: lade einen Skill-Ordner als ZIP über Settings und dann Features hoch. Einschränkung: der Skill bleibt privat in deinem eigenen Account und Admins können ihn nicht zentral verwalten.
- Skills API: erstelle und lade über die /v1/skills Endpoints hoch, für workspace-weiten Zugriff. Einschränkung: braucht das code execution Tool, und der Container hat keinen Netzwerkzugriff.
- Community-Listen: ComposioHQ pflegt awesome-claude-skills auf GitHub, eine kuratierte Liste von Community-Skills und Tools. Einschränkung: eine Awesome-Liste ist ein Index, keine Prüfung. Nichts darauf wurde für dich auditiert.

Anthropic veröffentlicht auf seiner Ressourcen-Seite ausserdem ein langes PDF namens The Complete Guide to Building Skills for Claude, das dem Format am nächsten an ein offizielles Autorenhandbuch kommt.

Anthropic ist beim Risiko unmissverständlich: nutze nur Skills, die du selbst erstellt oder von Anthropic bezogen hast, denn ein Skill kann Claude anweisen, Code auszuführen und Tools aufzurufen, die nicht zu seinem angegebenen Zweck passen. Lies vor der Installation jede Datei eines Skills, nicht nur die SKILL.md, und behandle einen Skill, der Daten von einer externen Adresse holt, als die riskanteste Kategorie, weil geholte Inhalte eigene Anweisungen mitbringen können. Einen Skill aus einem GitHub-Repository zu installieren heisst, Software von einem Fremden zu installieren.

## Claude Skills, die du zuerst installieren solltest

Jeder unten genannte Skill wurde am 28. August 2026 geprüft, indem wir seine eigene SKILL.md im Repository anthropics/skills gelesen haben, nicht indem wir die Zusammenfassung von jemand anderem kopiert haben. Wir haben nach Breite ausgewählt statt nach Rangliste: zwei, die dich besser darin machen, Agent-Tooling zu bauen, zwei, die die Qualität dessen heben, was du auslieferst, und drei Design-Skills, die Kategorie, nach der nach dem allgemeinen Begriff am härtesten gesucht wird. Der grösste Teil dieses Repositories steht unter Apache 2.0; die Dokument-Skills für Word, Excel, PowerPoint und PDF sind source-available statt Open Source.

- skill-creator: erstellt und editiert Skills und fährt Evals, die messen, wie zuverlässig eine description auslöst. Am besten für alle, die mehr als zwei Skills schreiben. Einschränkung: er repariert Struktur und Triggering, nicht dein Fachwissen.
- mcp-builder: baut MCP Server in Python mit FastMCP oder in Node und TypeScript mit dem MCP SDK. Am besten, wenn ein Skill das falsche Werkzeug ist und du eine lebende Verbindung brauchst. Einschränkung: nur Server-Design, kein Hosting und kein Auth.
- webapp-testing: steuert eine lokale Web-App mit Playwright, um Frontend-Verhalten zu prüfen, Screenshots aufzunehmen und Browser-Logs zu lesen. Am besten, um eine Änderung in der laufenden App zu prüfen, nicht nur in Tests. Einschränkung: nur lokale Apps.
- frontend-design: ästhetische Richtung für neue oder überarbeitete UI, mit dem Ziel, dass die Ausgabe nicht nach Template-Standard aussieht. Am besten für Solo-Builder ohne Designer. Einschränkung: er formt Typografie, er kennt deine Marke nicht.
- canvas-design: macht aus einer geschriebenen Design-Philosophie Poster und andere statische Stücke als PNG und PDF. Am besten für einmalige visuelle Assets. Einschränkung: statische Ausgabe, und er ist angewiesen, Originales zu schaffen statt eine Künstlerin oder einen Künstler zu kopieren.
- theme-factory: wendet eines von zehn voreingestellten Farb- und Font-Themes auf ein Deck, ein Doc oder eine HTML-Seite an, oder generiert ein neues. Am besten, damit verstreute Ergebnisse wie ein System aussehen. Einschränkung: er stylt, er layoutet nicht.
- claude-api: eine aktuelle Referenz für die Claude API und die SDKs, mit Model-IDs, Pricing, Streaming, Tool Use und Caching in acht Sprachen. Am besten, um Code gegen Claude zu schreiben. Einschränkung: er wird ohnehin schon mit Claude Code mitgeliefert.

Zwei ehrliche Einschränkungen zum ganzen Set. Erstens hängt Anthropic diesem Repository einen expliziten Disclaimer an: die Skills werden zu Demonstrations- und Bildungszwecken bereitgestellt, und was Claude tatsächlich tut, kann von dem abweichen, was der Skill beschreibt. Zweitens sind die besten Claude Code Skills für dich fast nie die berühmten. Ein dreizeiliger Skill, der festhält, wie dein Team Commit-Messages schreibt, feuert zehnmal am Tag; ein wunderschön gebauter Design-Skill, den du installiert hast, weil er beeindruckend aussah, sitzt da und kostet dich für immer 100 Tokens pro Session.

## Was ein Skill dich im Context wirklich kostet

Ein Skill, den du nie auslöst, kostet rund 100 Tokens, laut Anthropics eigener progressive-disclosure-Tabelle: name und description jedes installierten Skills sitzen ab dem Start im System Prompt, und sonst nichts. Der Preis, der wehtut, kommt nach dem Auslösen, denn in Claude Code landet der gerenderte Inhalt eines aufgerufenen Skills als einzelne Message in der Konversation und bleibt dort für den Rest der Session. Claude Code liest die Datei in späteren Runden nicht neu, ein langer Skill ist also eine langlebige Steuer.

- 30 installierte Skills mit rund 100 Tokens Metadaten je Skill: etwa 3.000 Tokens, die beim Start ausgegeben werden, ob du auch nur einen davon nutzt oder nicht.
- Ein Skill-Body an der empfohlenen Grenze von 5.000 Tokens, einmal aufgerufen: 5.000 Tokens, die für den Rest der Session in der Konversation bleiben.
- Fünf solche Skills in einer Session aufgerufen: etwa 25.000 Tokens, also genau das gemeinsame Budget, das Claude Code nach der Auto-Compaction wieder anhängt.
- Nach der Compaction behält Claude Code nur die ersten 5.000 Tokens jedes wieder angehängten Skills und füllt dieses Budget von 25.000 Tokens vom zuletzt aufgerufenen rückwärts, Skills die du früh aufgerufen hast, können also komplett verschwinden.
- Claude Code deckelt das Skill-Listing standardmässig bei 1 Prozent des Model Context Windows und jeden Eintrag bei 1.536 Zeichen description-Text, und wirft bei Überlauf zuerst die Beschreibungen deiner am wenigsten genutzten Skills raus.

Die Regel, die aus dieser Rechnung fällt: halte die description scharf und den Body kurz, und schieb alles Lange in Referenzdateien, die nur laden, wenn die Aufgabe danach greift. Anthropics Spezifikation empfiehlt genau deshalb, die SKILL.md unter 500 Zeilen zu halten. Es ist dieselbe Context-Budget-Disziplin, die unser Claude Code Material auf den Rest einer Agent-Session anwendet, und deshalb ist die Länge eines Skills eine Design-Vorgabe und kein Detail.

## Wann du gar keinen Skill schreiben solltest

Das meiste, was Leute als Skill verpacken, sollte kein Skill sein. Eine einmalige Anweisung gehört in den Prompt, den du sowieso gerade tippst. Ein Fakt, der in jeder Runde gilt, gehört in die CLAUDE.md, wo er immer geladen ist. Eine lebende externe Datenquelle gehört in einen MCP Server, weil geschriebene Anweisungen nichts abrufen können. Arbeit, die deinen Haupt-Context fluten würde, gehört in einen Subagent. Und alles, was jedes Mal passieren muss, ohne dass das Modell mitentscheidet, gehört in einen Hook. Ein Skill ist nur dann die richtige Antwort, wenn es um eine wiederholbare Prozedur geht, die du verfügbar, aber nicht dauerhaft geladen haben willst.

- Einmalige Anweisung: schreib sie in den Prompt. Ein Skill, den du einmal aufrufst, hat dich die Zeit zum Schreiben gekostet und danach in jeder Session rund 100 Tokens Metadaten.
- Projektregel oder Fakt: ab in die CLAUDE.md. Anthropic zieht die Grenze genau hier und weist darauf hin, dass ein Skill-Body nur beim Einsatz lädt, CLAUDE.md-Inhalt dagegen nicht.
- Live-Daten oder eine externe API: bau einen MCP Server. Ein Skill kann eine API beschreiben, er kann keine aufrufen, zu der der Agent keine Verbindung hat.
- Eine lange Untersuchung, die deinen Context füllen würde: gib sie einem Subagent und behalte nur das Ergebnis.
- Eine Garantie statt eines Vorschlags, etwa das Blockieren eines schlechten Commits: nimm einen Hook. Ein Skill sind Anweisungen, denen das Modell nicht folgen muss, und Anthropic rät zu Hooks, wenn Verhalten deterministisch erzwungen werden soll.

Der einfachste Test ist, ob du laut sagen kannst, wann der Skill feuern soll. Wenn du das nicht kannst, sagt es seine description auch nicht, und du hast ein Dokument geschrieben statt eines Skills.

## Was du davon diese Woche einrichten solltest

Drei Dinge entscheiden das jedes Mal: auf welcher Oberfläche du tatsächlich arbeitest, ob der Skill zwischen Oberflächen reisen muss, und ob das, was du verpackst, eine Prozedur oder ein Fakt ist. Sind die drei geklärt, ist der Bau selbst ein Ordner und eine Datei.

- Eine Person, die in Claude Code ausliefert: leg ~/.claude/skills/name/SKILL.md für die zwei Prozeduren an, die du am häufigsten neu tippst, und nutze die volle Claude Code frontmatter. Du brauchst die Portabilität der sechs Felder erst, wenn ein Skill deinen Rechner verlässt.
- Ein kleines Team auf einem Repo: leg die Skills in .claude/skills/ und committe sie, damit die Prozedur mit dem Code ausgeliefert wird und die nächste Person sie erbt. Setz disable-model-invocation: true auf alles mit Nebenwirkung, etwa ein Deploy.
- Dokumente und Kommunikation auf claude.ai: die vorgebauten PowerPoint-, Excel-, Word- und PDF-Skills sind bereits aktiv und brauchen kein Setup. Lade einen eigenen Skill für deinen Hausstil hoch, und denk daran, dass er privat in deinem Account bleibt.
- Bauen auf der Claude API: lade über die /v1/skills Endpoints hoch, für workspace-weiten Zugriff, halte die frontmatter auf den sechs Spezifikationsfeldern, und entwirf für einen Container ohne Netzwerkzugriff und ohne Paketinstallation.

Wenn du nur eine Sache machst: nimm die Prozedur, die du diese Woche zweimal in einen Chat eingefügt hast, leg sie mit einer SKILL.md in einen Ordner, und schreib eine description, die die Worte nennt, die du tatsächlich sagen würdest, wenn du sie willst. Der kostenlose Claude Code Kurs an der Agentic School geht das einmal komplett durch.

## Schritte

### 1. Wähle die Prozedur, die du ständig wiederholst

Nimm etwas, das du mehr als zweimal in einen Chat eingefügt hast: eine Release-Checkliste, eine Review-Routine, ein Report-Format. Wenn es ein Fakt statt einer Prozedur ist, gehört es stattdessen in die CLAUDE.md.

### 2. Leg den Skill-Ordner an

Erstelle ein Verzeichnis, dessen Name aus Kleinbuchstaben, Zahlen und Bindestrichen besteht, höchstens 64 Zeichen lang ist und keine führenden, abschliessenden oder aufeinanderfolgenden Bindestriche hat. In Claude Code wird dieser Verzeichnisname zum slash command, den du tippst.

### 3. Schreib die zwei Pflichtfelder in die frontmatter

Leg im Ordner eine SKILL.md an, die mit YAML frontmatter beginnt und name setzt, passend zum Verzeichnisnamen, sowie description, bis zu 1.024 Zeichen, die sowohl sagt, was der Skill macht, als auch, wann er einzusetzen ist. Die description ist der einzige Text, der beim Start geladen wird, pack also die Trigger-Worte hinein.

### 4. Schreib den Body als Anweisungen, nicht als Prosa

Schreib unter die frontmatter nummerierte Schritte und explizite Regeln. Halte die SKILL.md unter 500 Zeilen, das ist Anthropics Empfehlung, und verschieb langes Referenzmaterial in separate Dateien im Ordner, damit es nur lädt, wenn die Aufgabe es braucht.

### 5. Leg den Ordner dorthin, wo die Oberfläche ihn liest

Für Claude Code nutze ~/.claude/skills/name/ für persönlich oder .claude/skills/name/ im Repo für ein Projekt. Für claude.ai zippe den Ordner und lade ihn über Settings und dann Features hoch. Für die API erstelle ihn über die /v1/skills Endpoints. Skills synchronisieren nicht zwischen diesen Wegen, installiere ihn also auf jeder Oberfläche, auf der du ihn haben willst.

### 6. Halte ihn portabel, wenn er reisen muss

Wenn derselbe Skill auf mehr als einer Oberfläche laufen soll, beschränke die frontmatter auf die sechs Spezifikationsfelder: name, description, license, compatibility, metadata und allowed-tools. Ein Claude Code only Feld wie argument-hint lässt einen Upload auf claude.ai oder in die Skills API mit einem Unexpected-Key-Fehler scheitern.

### 7. Prüfe, dass er geladen wurde

Frag in Claude Code, welche Skills verfügbar sind, und prüfe, dass deiner mit seiner description gelistet ist, dann ruf ihn direkt über seinen slash command auf. Wenn der Command funktioniert, aber die description fehlt, ist das YAML nicht geparst worden: fahr claude plugin validate gegen dein skills-Verzeichnis, oder starte mit dem Debug-Flag, um den Parse-Fehler zu sehen.

## Häufige Fragen

### Was sind Claude Skills?

Claude Skills sind Ordner, die Claude eine bestimmte Fähigkeit geben. Jeder Ordner enthält eine SKILL.md mit YAML frontmatter, die zwei Pflichtfelder trägt, name und description, gefolgt von Markdown-Anweisungen, plus alle Scripts oder Referenzdateien, die du dazupacken willst. Anthropic nennt die Funktion Agent Skills und hat sie im Dezember 2025 als offenen Standard veröffentlicht. Claude lädt beim Start nur die rund 100 Tokens Metadaten und liest die vollständigen Anweisungen erst, wenn deine Anfrage zur description passt.

### Wie füge ich Skills zu Claude Code hinzu?

Leg ein Verzeichnis unter ~/.claude/skills/dein-skill-name/ für einen persönlichen Skill an, oder .claude/skills/dein-skill-name/ in einem Repository für einen Projekt-Skill, und leg eine SKILL.md hinein, mit name und description in der frontmatter. Der Verzeichnisname wird zum slash command. Claude Code lädt Skills auch aus Plugins, du kannst also ein veröffentlichtes Set installieren, indem du einen plugin marketplace hinzufügst, zum Beispiel Anthropics eigenes Repository anthropics/skills, und dessen Plugin document-skills oder example-skills installierst.

### Wie erstelle ich einen Claude Skill?

Leg einen Ordner an, füge eine SKILL.md hinzu, und gib ihr zwei frontmatter-Felder. Der name darf höchstens 64 Zeichen aus Kleinbuchstaben, Zahlen und Bindestrichen haben, darf nicht mit einem Bindestrich beginnen oder enden, darf keine aufeinanderfolgenden Bindestriche enthalten und muss zum Ordnernamen passen. Die description darf höchstens 1.024 Zeichen haben und muss sowohl sagen, was der Skill macht, als auch, wann er einzusetzen ist, denn das ist der Text, gegen den das Modell deine Anfrage matcht. Alles unter der frontmatter sind ganz normale Markdown-Anweisungen, und Anthropic empfiehlt, die Datei unter 500 Zeilen zu halten.

### Was ist der Unterschied zwischen Claude Skills und Subagents?

Claude Skills vs Subagents ist ein Unterschied der Art, nicht der Grösse. Ein Skill ist Inhalt: Anweisungen und Dateien, die in die aktuelle Konversation geladen werden, wenn deine Anfrage zu seiner description passt, und die bis dahin rund 100 Tokens Metadaten kosten. Ein Subagent ist ein eigener Context, der losgeht, mit eigenen Tools arbeitet und nur ein Ergebnis zurückgibt, und genau das verhindert, dass eine lange Untersuchung dein Haupt-Context-Window füllt. Nimm einen Skill, wenn der Agent einer bekannten Prozedur folgen soll. Nimm einen Subagent, wenn die Arbeit selbst deinen Context fluten würde und du nur die Antwort brauchst.

### Gibt es einen offiziellen Claude Skills Marketplace?

Es gibt kein separates Anthropic Skills Marketplace Produkt. Die Verteilung läuft über das Claude Code Plugin-System: Anthropic betreibt einen offiziellen plugin marketplace unter anthropics/claude-plugins-official, den die Dokumentation als den einzigen Marketplace beschreibt, den Claude Code von sich aus registriert, und die Open-Source-Skills liegen im Repository anthropics/skills, das du selbst als plugin marketplace registrieren kannst. Auf claude.ai lädst du ein ZIP über Settings und dann Features hoch, und über die Claude API lädst du über die /v1/skills Endpoints hoch. Community-Indizes wie awesome-claude-skills von ComposioHQ listen Skills von Dritten, prüfen aber keinen davon.

### Funktionieren Claude Skills auch ausserhalb von Claude Code?

Ja. Anthropic gibt an, dass Agent Skills in claude.ai, Claude Code, dem Claude Agent SDK und der Claude Developer Platform unterstützt werden, und das Format wurde als offener Standard veröffentlicht, damit andere Agent-Produkte es übernehmen können. Der Haken ist, dass eigene Skills nicht zwischen den Oberflächen synchronisieren: ein Skill, den du auf claude.ai hochlädst, ist über die API nicht verfügbar, und Claude Code Skills liegen im Dateisystem und sind von beidem getrennt. Auch die frontmatter unterscheidet sich, denn claude.ai und die Skills API akzeptieren nur die sechs Spezifikationsfelder, während Claude Code viel mehr akzeptiert.

### Was sind die besten Claude Skills?

Für die meisten Builder sind die besten Claude Skills die kleinen, die du selbst schreibst, denn ein Skill, der festhält, wie dein Team wirklich arbeitet, feuert jeden Tag, während ein berühmter meist ungenutzt herumsitzt und rund 100 Tokens pro Session kostet. Wenn du ein Startset aus Anthropics eigenem Repository willst: skill-creator hilft dir, weitere Skills zu schreiben und zu bewerten, mcp-builder deckt das Bauen von MCP Servern in Python oder TypeScript ab, webapp-testing steuert eine lokale App mit Playwright, und frontend-design, canvas-design und theme-factory sind die Design-Skills. Anthropic kennzeichnet dieses Repository als Demonstrations- und Bildungsmaterial, prüfe also alles, bevor du es installierst.