Claude Skills erklärt: Was sind Agent Skills?

Du hast von „Agent Skills” oder „Claude Skills” gehört und fragst dich, was das eigentlich ist – und ob du dir das merken musst? Kurze Antwort: ja, schon. Längere Antwort: lies weiter. Skills sind einer der wichtigsten Bausteine, wenn du Claude für spezialisierte Aufgaben einsetzen willst, ohne jedes Mal ellenlange Anweisungen einzutippen.

Dieser Artikel gehört zu unserem Überblick über Claude Code, MCP und KI-Agenten. Wenn du noch ganz neu dabei bist, lohnt sich ein kurzer Blick dorthin.

---

Was sind Claude Skills? (in einem Satz)

Claude Skills sind wiederverwendbare, dateibasierte Wissenspakete, die Claude automatisch lädt, wenn sie für eine Aufgabe relevant sind.

Stell dir vor, du stellst einen Praktikanten ein. Anstatt ihm bei jedem Auftrag von vorne zu erklären, wie ihr Excel-Reporting funktioniert, gibst du ihm einmalig ein Onboarding-Dokument. Genau das ist ein Skill: ein strukturiertes Paket aus Anweisungen, Skripten und Referenzmaterial – bereit zum Abruf, aber ohne deinen Schreibtisch zu verstopfen, solange du es nicht brauchst.

Laut offizieller Anthropic-Dokumentation verwandeln Skills einen universellen Agenten in einen Spezialisten – für wiederkehrende, domänenspezifische Workflows.

---

Wie ein Skill aufgebaut ist (SKILL.md & Co.)

Der Kern jedes Skills ist ein Ordner mit einer Pflichtdatei: SKILL.md.

Die Struktur ist bewusst simpel gehalten. Ein minimaler Skill sieht so aus:

mein-skill/
└── SKILL.md

Die SKILL.md beginnt mit YAML-Frontmatter und enthält danach die eigentlichen Anweisungen im Markdown-Format:

---
name: mein-skill-name
description: Beschreibt, was der Skill tut und wann Claude ihn nutzen soll.
---

# Mein Skill

## Anweisungen
Schritt-für-Schritt-Vorgaben für Claude…

## Beispiele
- Beispielaufruf 1
- Beispielaufruf 2

Die beiden Pflichtfelder im Frontmatter:

Sobald der Skill mehr braucht, kann der Ordner wachsen:

pdf-skill/
├── SKILL.md          ← Hauptanweisungen
├── FORMS.md          ← Detailanleitung für Formulare
├── REFERENCE.md      ← API-Referenz
└── scripts/
    └── fill_form.py  ← Ausführbares Skript

Das ist das Prinzip der „Progressive Disclosure”: Claude lädt Inhalte in Stufen – erst nur die Metadaten aus dem Frontmatter (~100 Tokens), dann bei Bedarf die SKILL.md (unter 5.000 Tokens), und erst wenn nötig einzelne Zusatzdateien oder Skripte. Skripte werden ausgeführt, aber ihr Quellcode landet nie im Kontextfenster – nur der Output. Das spart Kontext und macht komplexe Skills effizient.

---

Was Skills können – mit Beispielen

Skills erweitern Claude um spezialisiertes Domänenwissen und ausführbaren Code, ohne dass du das jedes Mal neu eingeben musst.

Anthropic stellt vier fertige Skills bereit, die sofort einsatzbereit sind:

Dazu gibt es einen Open-Source-Skill im GitHub-Repository: den Claude API Skill, der Claude mit aktuellem API-Referenzmaterial in 8 Programmiersprachen ausstattet. Er ist in Claude Code bereits vorinstalliert.

Du kannst außerdem eigene Skills bauen – für dein Team-spezifisches Reporting-Format, dein CMS, deine interne Terminologie. Genau das zeigen wir im Artikel Eigene Agent Skill erstellen.

---

Skills vs. einfache Prompts: der Unterschied

Skills sind keine neue KI-Magie – aber sie lösen ein echtes Problem, das Prompts nicht lösen können.

Hier ist die ehrliche Einordnung.

Ja, ein Skill enthält im Kern Textanweisungen – ähnlich wie ein Prompt. Und ja, du könntest denselben Text theoretisch jedes Mal in den Chat eingeben. Wer Skills als „aufgewertete Prompts” oder „Marketing” bezeichnet, trifft damit einen Teil der Wahrheit.

Aber der entscheidende Unterschied liegt woanders:

Der eigentliche Wert von Skills ist Kontexteffizienz und Automatisierung. Claude weiß durch die Metadaten, dass ein Skill existiert, verbraucht dafür aber nur ~100 Tokens. Den Rest lädt er nur, wenn er ihn braucht. Bei einem langen Agenten-Workflow mit zehn potenziellen Fähigkeiten macht das einen erheblichen Unterschied.

Wer trotzdem sagt „das ist doch nur ein Prompt” – stimmt zum Teil, aber auch ein Hammer ist „nur Metall und Holz”. Die Verpackung und der Workflow drumherum entscheiden, ob es nützlich ist.

---

Wo Skills funktionieren

Skills laufen in Claude Code, auf claude.ai und über die Claude API – aber mit unterschiedlichem Scope.

Eine Übersicht:

Ein wichtiger Punkt: Skills synchronisieren sich nicht zwischen Plattformen. Was du in claude.ai hochlädst, steht der API nicht automatisch zur Verfügung – und umgekehrt. In Claude Code sind Skills Ordner auf deinem Dateisystem, getrennt vom Rest.

In Claude Code liegen Skills entweder unter ~/.claude/skills/ (persönlich, für alle Projekte) oder unter .claude/skills/ (projektspezifisch). Claude Code entdeckt sie automatisch.

Weitere Unterschiede bei der Netzwerkumgebung: Die Claude API erlaubt in Skills keinen Internetzugang und kein Nachinstallieren von Paketen. Claude Code dagegen hat vollen Netzwerkzugang – Skills verhalten sich dort wie normale Programme auf deinem Rechner.

---

Wie du loslegst

Der schnellste Einstieg: einen bestehenden Skill nutzen oder einen eigenen in fünf Minuten bauen.

Vorgefertigte Skills auf claude.ai

Wenn du claude.ai mit einem Pro-, Max-, Team- oder Enterprise-Abo nutzt und Code Execution aktiviert hast, sind die Dokument-Skills (PDF, Word, Excel, PowerPoint) bereits aktiv. Du musst nichts weiter tun – frag Claude einfach, eine Excel-Datei zu analysieren, und er erledigt es.

Eigenen Skill in Claude Code anlegen

1. Erstelle einen Ordner: .claude/skills/mein-skill/
2. Lege eine SKILL.md darin an mit Name, Description und Anweisungen (Struktur siehe oben)
3. Claude Code erkennt den Skill beim nächsten Start automatisch

Das war’s. Kein Terminal-Befehl, kein API-Key, kein Deployment. Eine vollständige Schritt-für-Schritt-Anleitung findest du im Artikel Eigene Agent Skill erstellen.

Via API

Über die Anthropic API kannst du Skills programmatisch hochladen und in Agenten einbinden – das braucht etwas mehr Einarbeitungszeit, lohnt sich aber für Produktionssysteme. Details dazu in der offiziellen API-Dokumentation.

---

Abgrenzung: Skills vs. MCP vs. Subagents

Das sind drei Konzepte, die Anfänger schnell durcheinander bringen. Kurze Orientierung:

• Skills = Wissenspakete. Sie sagen Claude, wie er etwas tun soll. Kein externer Server nötig.
• MCP (Model Context Protocol) = Integrations-Protokoll. MCP-Server verbinden Claude mit externen Tools, Datenbanken oder APIs. Skills und MCP ergänzen sich – ein Skill kann einem MCP-Server Anweisungen mitgeben, wie er eingesetzt werden soll. Mehr dazu im Artikel Was ist ein MCP-Server?.
• Subagents = Eigenständige KI-Instanzen innerhalb eines Multi-Agenten-Workflows. Sie bekommen Aufgaben delegiert und können selbst Skills nutzen.

Eine tiefere Gegenüberstellung findest du in Skills vs. MCP vs. Subagents.

---

Wie es weitergeht

• Die andere Erweiterung: was ein MCP-Server ist
• Wo Skills laufen: Claude Code
• Die Abgrenzung: Skills vs MCP vs Subagents

FAQ: Häufige Fragen zu Claude Skills

Was sind Claude Skills / Agent Skills?

Claude Skills (offiziell: Agent Skills) sind wiederverwendbare, dateibasierte Fähigkeitspakete, die aus einem Ordner mit einer SKILL.md-Datei und optionalen Skripten und Ressourcen bestehen. Claude lädt sie automatisch, wenn sie für eine Anfrage relevant sind – ohne dass du die Anweisungen jedes Mal neu eingeben musst.

Sind Skills nur aufgewertete Prompts?

Teilweise ja, teilweise nein. Die Anweisungen in einem Skill ähneln einem Prompt. Der Unterschied: Skills werden nur bei Bedarf geladen (Kontexteffizienz), können ausführbaren Code enthalten, sind plattformübergreifend wiederverwendbar und lassen sich im Team oder Workspace teilen. Wer Skills als „nur Marketing” abtut, unterschätzt den praktischen Unterschied im Arbeitsalltag.

Was ist der Unterschied zwischen Skills und MCP?

Skills sind Wissenspakete mit Anweisungen (und optionalem Code), die Claude intern nutzt. MCP-Server sind externe Dienste, die Claude über ein standardisiertes Protokoll anspricht, um auf Daten oder Tools zuzugreifen – zum Beispiel eine Datenbank oder eine API. Beides kann kombiniert werden. Details: Skills vs. MCP vs. Subagents.

Brauche ich Programmierkenntnisse für Skills?

Für einfache Skills: nein. Eine SKILL.md mit sinnvollen Anweisungen schreibt man in normalem Markdown. Wenn du Skripte in den scripts/-Ordner packst, brauchst du etwas Python oder Bash – aber das ist optional. Der Einstieg ist bewusst niedrigschwellig gehalten.

Auf welchen Plänen sind Skills verfügbar?

Auf claude.ai sind eigene Skills (Custom Skills) für Pro-, Max-, Team- und Enterprise-Nutzer verfügbar, sofern Code Execution aktiviert ist. Die Dokument-Skills (PDF, Excel etc.) laufen ebenfalls auf diesen Plänen. In Claude Code sind eigene Skills für alle Nutzer kostenlos nutzbar – sie liegen einfach als Ordner auf dem Dateisystem.

Sind Skills sicher?

Grundsätzlich ja – sofern du nur Skills verwendest, die du selbst erstellt hast oder die von Anthropic stammen. Skills können Code ausführen und haben je nach Plattform Netzwerkzugang. Ein bösartig gestalteter Skill von einer unbekannten Quelle kann Claude dazu bringen, unerwünschte Aktionen auszuführen. Anthropic empfiehlt ausdrücklich: Skills wie Software behandeln – nur aus vertrauenswürdigen Quellen installieren.

---

Fazit

Claude Skills sind kein Hype-Begriff, sondern ein durchdachtes Architekturprinzip: Einmal erstellt, automatisch verfügbar, kontextschonend geladen. Ob du Claude täglich für Dokumente, Code-Reviews oder interne Workflows nutzt – Skills machen den Unterschied zwischen einem Allround-Assistenten und einem echten Spezialisten.

Der nächste Schritt: Schau dir an, wie du deinen ersten eigenen Skill baust → Eigene Agent Skill erstellen.