Überblick

Warum Skills verwenden

Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die Claude domänenspezifisches Fachwissen geben: Workflows, Kontext und Best Practices, die allgemeine Agenten zu Spezialisten machen. Anders als Prompts, also gesprächsbezogene Anweisungen für einmalige Aufgaben, werden Skills bei Bedarf geladen und ersparen es, dieselben Hinweise in mehreren Gesprächen immer wieder bereitzustellen.

Wichtigste Vorteile:

• Claude spezialisieren: Fähigkeiten für domänenspezifische Aufgaben anpassen
• Wiederholung reduzieren: einmal erstellen, automatisch wiederverwenden
• Fähigkeiten kombinieren: mehrere Skills zu komplexen Workflows verbinden

Skills verwenden

Anthropic stellt vorgefertigte Agent Skills für häufige Dokumentaufgaben bereit (PowerPoint, Excel, Word, PDF). Du kannst auch eigene benutzerdefinierte Skills erstellen. Beide funktionieren gleich: Claude verwendet sie automatisch, wenn sie zu deiner Anfrage passen.

Vorgefertigte Agent Skills stehen allen Nutzern auf claude.ai und über die Claude API zur Verfügung. Die vollständige Liste findest du unten im Abschnitt Verfügbare Skills.

Benutzerdefinierte Skills ermöglichen es, Domänenwissen und Organisationswissen zu paketieren. Sie sind in Claude-Produkten verfügbar: erstelle sie in Claude Code, lade sie über die API hoch oder füge sie in den Einstellungen von claude.ai hinzu.

Wie Skills funktionieren

Skills nutzen Claudes VM-Umgebung, um Fähigkeiten bereitzustellen, die mit Prompts allein nicht möglich wären. Claude läuft in einer virtuellen Maschine mit Zugriff auf das Dateisystem. Dadurch können Skills als Verzeichnisse existieren, die Anweisungen, ausführbaren Code und Referenzmaterial enthalten, ähnlich wie ein Onboarding-Leitfaden für ein neues Teammitglied.

Diese dateisystembasierte Architektur ermöglicht progressive Offenlegung: Claude lädt Informationen stufenweise nach Bedarf, statt den Kontext schon zu Beginn vollständig zu belegen.

Drei Arten von Skill-Inhalten, drei Ladeebenen

Skills können drei Arten von Inhalten enthalten, die zu unterschiedlichen Zeitpunkten geladen werden:

Ebene 1: Metadaten (immer geladen)

Inhaltstyp: Anweisungen. Das YAML-Frontmatter der Skill liefert Informationen zur Erkennung:

---
name: PDF Processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude lädt diese Metadaten beim Start und nimmt sie in den Systemprompt auf. Dieser leichte Ansatz bedeutet, dass viele Skills installiert werden können, ohne den Kontext stark zu belasten; Claude weiß nur, dass jede Skill existiert und wann sie zu verwenden ist.

Ebene 2: Anweisungen (geladen, wenn ausgelöst)

Inhaltstyp: Anweisungen. Der Hauptteil von SKILL.md enthält prozedurales Wissen: Workflows, Best Practices und Anleitung:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:
```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Wenn eine Anfrage zur Beschreibung einer Skill passt, liest Claude SKILL.md per bash aus dem Dateisystem. Erst dann gelangt dieser Inhalt in das Kontextfenster.

Ebene 3: Ressourcen und Code (nach Bedarf geladen)

Inhaltstypen: Anweisungen, Code und Ressourcen. Skills können zusätzliche Materialien bündeln:

pdf-skill/
|-- SKILL.md (main instructions)
|-- FORMS.md (form-filling guide)
|-- REFERENCE.md (detailed API reference)
`-- scripts/
  `-- fill_form.py (utility script)

Anweisungen: zusätzliche Markdown-Dateien (FORMS.md, REFERENCE.md) mit spezialisierter Anleitung und Workflows.

Code: ausführbare Skripte (fill_form.py, validate.py), die Claude über bash ausführt; Skripte liefern deterministische Abläufe, ohne Kontext zu verbrauchen.

Ressourcen: Referenzmaterial wie Datenbankschemata, API-Dokumentation, Vorlagen oder Beispiele.

Claude greift nur auf diese Dateien zu, wenn sie referenziert werden. Das Dateisystemmodell bedeutet, dass jeder Inhaltstyp andere Stärken hat: Anweisungen für flexible Führung, Code für Zuverlässigkeit, Ressourcen für faktenbezogenes Nachschlagen.

Progressive Offenlegung stellt sicher, dass zu jedem Zeitpunkt nur relevante Inhalte das Kontextfenster belegen.

Die Skills-Architektur

Skills laufen in einer Code-Ausführungsumgebung, in der Claude Zugriff auf das Dateisystem, bash-Befehle und Codeausführung hat. Man kann es so sehen: Skills existieren als Verzeichnisse auf einer virtuellen Maschine, und Claude interagiert mit ihnen über dieselben bash-Befehle, mit denen du Dateien auf deinem Computer navigieren würdest.

Wie Claude auf Skill-Inhalte zugreift:

Wenn eine Skill ausgelöst wird, verwendet Claude bash, um SKILL.md aus dem Dateisystem zu lesen und die Anweisungen in das Kontextfenster zu bringen. Wenn diese Anweisungen andere Dateien wie FORMS.md oder ein Datenbankschema referenzieren, liest Claude diese Dateien ebenfalls mit weiteren bash-Befehlen. Wenn Anweisungen ausführbare Skripte erwähnen, führt Claude sie über bash aus und erhält nur die Ausgabe; der Skriptcode selbst gelangt nie in den Kontext.

Was diese Architektur ermöglicht:

Dateizugriff nach Bedarf: Claude liest nur die Dateien, die für die jeweilige Aufgabe nötig sind. Eine Skill kann Dutzende Referenzdateien enthalten, aber wenn deine Aufgabe nur das Sales-Schema benötigt, lädt Claude nur diese eine Datei. Der Rest bleibt im Dateisystem und verbraucht keine Tokens.

Effiziente Skriptausführung: Wenn Claude validate_form.py ausführt, wird der Code des Skripts nie in das Kontextfenster geladen. Nur die Skriptausgabe, etwa "Validation passed" oder konkrete Fehlermeldungen, verbraucht Tokens. Das macht Skripte viel effizienter, als Claude gleichwertigen Code spontan generieren zu lassen.

Keine praktische Grenze für gebündelte Inhalte: Da Dateien keinen Kontext verbrauchen, bis auf sie zugegriffen wird, können Skills umfassende API-Dokumentation, große Datensätze, viele Beispiele oder beliebige Referenzmaterialien enthalten. Nicht verwendete gebündelte Inhalte haben keine Kontextkosten.

Dieses dateisystembasierte Modell macht progressive Offenlegung möglich. Claude navigiert deine Skill so, wie du bestimmte Abschnitte eines Onboarding-Leitfadens aufrufen würdest, und greift genau auf das zu, was die jeweilige Aufgabe erfordert.

Beispiel: Laden einer PDF-Verarbeitungs-Skill

So lädt und verwendet Claude eine PDF-Verarbeitungs-Skill:

1. Start: Der Systemprompt enthält PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Nutzeranfrage: "Extrahiere den Text aus diesem PDF und fasse ihn zusammen"
3. Claude ruft auf: bash: read pdf-skill/SKILL.md -> Anweisungen werden in den Kontext geladen
4. Claude entscheidet: Formularausfüllung ist nicht nötig, daher wird FORMS.md nicht gelesen
5. Claude führt aus: Verwendet die Anweisungen aus SKILL.md, um die Aufgabe abzuschließen

Das Diagramm zeigt:

1. Standardzustand mit vorab geladenem Systemprompt und Skill-Metadaten
2. Claude löst die Skill aus, indem es SKILL.md per bash liest
3. Claude liest bei Bedarf zusätzliche gebündelte Dateien wie FORMS.md
4. Claude fährt mit der Aufgabe fort

Dieses dynamische Laden stellt sicher, dass nur relevante Skill-Inhalte das Kontextfenster belegen.

Wo Skills funktionieren

Skills sind in Claudes Agent-Produkten verfügbar:

Claude API

Die Claude API unterstützt sowohl vorgefertigte Agent Skills als auch benutzerdefinierte Skills. Beide funktionieren identisch: Gib die relevante skill_id im Parameter container zusammen mit dem Code-Ausführungstool an.

Voraussetzungen: Die Nutzung von Skills über die API erfordert drei Beta-Header:

• code-execution-2025-08-25 - Skills laufen im Code-Ausführungscontainer
• skills-2025-10-02 - Aktiviert die Skills-Funktionalität
• files-api-2025-04-14 - Erforderlich zum Hoch- und Herunterladen von Dateien in den bzw. aus dem Container

Verwende vorgefertigte Agent Skills, indem du ihre skill_id referenzierst (z. B. pptx, xlsx), oder erstelle und lade eigene Skills über die Skills API hoch (/v1/skills-Endpunkte). Benutzerdefinierte Skills werden organisationsweit geteilt.

Mehr dazu unter Skills mit der Claude API verwenden.

Claude Code

Claude Code unterstützt nur benutzerdefinierte Skills.

Benutzerdefinierte Skills: Erstelle Skills als Verzeichnisse mit SKILL.md-Dateien. Claude erkennt und verwendet sie automatisch.

Benutzerdefinierte Skills in Claude Code sind dateisystembasiert und erfordern keine API-Uploads.

Mehr dazu unter Skills in Claude Code verwenden.

Claude.ai

Claude.ai unterstützt sowohl vorgefertigte Agent Skills als auch benutzerdefinierte Skills.

Vorgefertigte Agent Skills: Diese Skills arbeiten bereits im Hintergrund, wenn du Dokumente erstellst. Claude verwendet sie ohne zusätzliche Einrichtung.

Benutzerdefinierte Skills: Lade eigene Skills als zip-Dateien über Settings > Features hoch. Verfügbar in Pro-, Max-, Team- und Enterprise-Plänen mit aktivierter Codeausführung. Benutzerdefinierte Skills gelten für einzelne Nutzer; sie werden nicht organisationsweit geteilt und können nicht zentral von Administratoren verwaltet werden.

Weitere Informationen zur Verwendung von Skills in Claude.ai findest du in diesen Ressourcen im Claude Help Center:

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Tech Claude your way of working using Skills

Skill-Struktur

Jede Skill benötigt eine SKILL.md-Datei mit YAML-Frontmatter:

---
name: Your Skill Name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Pflichtfelder: name und description

Dies sind die einzigen beiden Felder, die im YAML-Frontmatter unterstützt werden.

Frontmatter-Grenzen:

• name: maximal 64 Zeichen
• description: maximal 1024 Zeichen

Die description sollte sowohl enthalten, was die Skill tut, als auch wann Claude sie verwenden sollte. Vollständige Hinweise zum Schreiben findest du im Best-Practices-Leitfaden.

Sicherheitsaspekte

Wir empfehlen dringend, Skills nur aus vertrauenswürdigen Quellen zu verwenden: Skills, die du selbst erstellt oder von Anthropic erhalten hast. Skills geben Claude neue Fähigkeiten durch Anweisungen und Code. Das macht sie leistungsfähig, bedeutet aber auch, dass eine bösartige Skill Claude dazu bringen kann, Tools aufzurufen oder Code auf eine Weise auszuführen, die nicht zum angegebenen Zweck der Skill passt.

Wichtige Sicherheitsaspekte:

• Gründlich prüfen: Sieh dir alle Dateien an, die in der Skill enthalten sind: SKILL.md, Skripte, Bilder und andere Ressourcen. Achte auf ungewöhnliche Muster wie unerwartete Netzwerkaufrufe, Dateizugriffsmuster oder Vorgänge, die nicht zum angegebenen Zweck der Skill passen
• Externe Quellen sind riskant: Skills, die Daten von externen URLs abrufen, sind besonders riskant, da abgerufene Inhalte bösartige Anweisungen enthalten können. Selbst vertrauenswürdige Skills können kompromittiert werden, wenn sich ihre externen Abhängigkeiten im Laufe der Zeit ändern
• Tool-Missbrauch: Bösartige Skills können Tools (Dateioperationen, bash-Befehle, Codeausführung) auf schädliche Weise aufrufen
• Datenexposition: Skills mit Zugriff auf sensible Daten könnten so gestaltet sein, dass sie Informationen an externe Systeme weitergeben
• Wie Softwareinstallation behandeln: Verwende nur Skills aus vertrauenswürdigen Quellen. Sei besonders vorsichtig, wenn du Skills in Produktionssysteme mit Zugriff auf sensible Daten oder kritische Vorgänge integrierst

Verfügbare Skills

Vorgefertigte Agent Skills

Die folgenden vorgefertigten Agent Skills sind sofort verfügbar:

• PowerPoint (pptx): Präsentationen erstellen, Folien bearbeiten, Präsentationsinhalte analysieren
• Excel (xlsx): Tabellen erstellen, Daten analysieren, Berichte mit Diagrammen erzeugen
• Word (docx): Dokumente erstellen, Inhalte bearbeiten, Text formatieren
• PDF (pdf): Formatierte PDF-Dokumente und Berichte erzeugen

Diese Skills sind in Claude API und claude.ai verfügbar. Lies das Quickstart-Tutorial, um sie in der API zu verwenden.

Beispiele für benutzerdefinierte Skills

Vollständige Beispiele für benutzerdefinierte Skills findest du im Skills cookbook.

Einschränkungen und Grenzen

Diese Einschränkungen zu verstehen hilft dir, den Einsatz deiner Skills sinnvoll zu planen.

Verfügbarkeit über Oberflächen hinweg

Benutzerdefinierte Skills werden nicht zwischen Oberflächen synchronisiert. Skills, die auf eine Oberfläche hochgeladen wurden, sind nicht automatisch auf anderen verfügbar:

• Skills, die auf Claude.ai hochgeladen wurden, müssen separat in die API hochgeladen werden
• Skills, die über die API hochgeladen wurden, sind in Claude.ai nicht verfügbar
• Claude Code Skills sind dateisystembasiert und sowohl von Claude.ai als auch von der API getrennt

Du musst Skills für jede Oberfläche, auf der du sie verwenden möchtest, separat verwalten und hochladen.

Freigabeumfang

Skills haben je nach Einsatzort unterschiedliche Freigabemodelle:

• Claude.ai: nur einzelner Nutzer; jedes Teammitglied muss separat hochladen
• Claude API: workspaceweit; alle Workspace-Mitglieder können auf hochgeladene Skills zugreifen
• Claude Code: persönlich (~/.claude/skills/) oder projektbasiert (.claude/skills/)

Claude.ai unterstützt derzeit keine zentrale Administratorverwaltung oder organisationsweite Verteilung benutzerdefinierter Skills.

Einschränkungen der Laufzeitumgebung

Skills laufen im Code-Ausführungscontainer mit diesen Einschränkungen:

• Kein Netzwerkzugriff: Skills können keine externen API-Aufrufe machen und nicht auf das Internet zugreifen
• Keine Paketinstallation zur Laufzeit: Nur vorinstallierte Pakete sind verfügbar. Während der Ausführung können keine neuen Pakete installiert werden
• Nur vorkonfigurierte Abhängigkeiten: Die Liste verfügbarer Pakete findest du in der Dokumentation zum Code-Ausführungstool

Plane deine Skills so, dass sie innerhalb dieser Grenzen funktionieren.

Nächste Schritte