Agent Skills

Warum Skills verwenden

Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die Claude mit domänenspezifischem Fachwissen ausstatten: Workflows, Kontext und Best Practices, die allgemeine Agenten in Spezialisten verwandeln. Im Gegensatz zu Prompts (Anweisungen auf Gesprächsebene für einmalige Aufgaben) werden Skills bei Bedarf geladen und eliminieren die Notwendigkeit, die gleiche Anleitung wiederholt über mehrere Gespräche hinweg bereitzustellen.

Wichtigste Vorteile:

• Claude spezialisieren: Passen Sie Funktionen für domänenspezifische Aufgaben an
• Wiederholung reduzieren: Erstellen Sie einmal, verwenden Sie automatisch
• Funktionen kombinieren: Kombinieren Sie Skills, um komplexe Workflows zu erstellen

Skills verwenden

Anthropic bietet vorgefertigte Agent Skills für häufige Dokumentaufgaben (PowerPoint, Excel, Word, PDF) an, und Sie können Ihre eigenen benutzerdefinierten Skills erstellen. Beide funktionieren auf die gleiche Weise. Claude verwendet sie automatisch, wenn sie für Ihre Anfrage relevant sind.

Vorgefertigte Agent Skills sind für alle Benutzer auf claude.ai und über die Claude API verfügbar. Siehe den Abschnitt Verfügbare Skills unten für die vollständige Liste.

Benutzerdefinierte Skills ermöglichen es Ihnen, Domänenfachwissen und Organisationswissen zu verpacken. Sie sind über alle Claude-Produkte verfügbar: Erstellen Sie sie in Claude Code, laden Sie sie über die API hoch oder fügen Sie sie in den claude.ai-Einstellungen hinzu.

Wie Skills funktionieren

Skills nutzen Claudes VM-Umgebung, um Funktionen bereitzustellen, die mit Prompts allein nicht möglich sind. Claude läuft in einer virtuellen Maschine mit Dateisystemzugriff, was Skills ermöglicht, als Verzeichnisse zu existieren, die Anweisungen, ausführbaren Code und Referenzmaterialien enthalten, organisiert wie ein Onboarding-Leitfaden, den Sie für ein neues Teammitglied erstellen würden.

Diese dateisystembasierte Architektur ermöglicht progressive Offenlegung: Claude lädt Informationen in Phasen bei Bedarf, anstatt den Kontext im Voraus zu verbrauchen.

Drei Arten von Skill-Inhalten, drei Ladeebenen

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

Ebene 1: Metadaten (immer geladen)

Inhaltstyp: Anweisungen. Das YAML-Frontmatter der Skill bietet Erkennungsinformationen:

---
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 fügt sie in den System-Prompt ein. Dieser leichte Ansatz bedeutet, dass Sie viele Skills installieren können, ohne dass der Kontext belastet wird; Claude kennt nur jede Skill und wann sie zu verwenden ist.

Ebene 2: Anweisungen (geladen bei Auslösung)

Inhaltstyp: Anweisungen. Der Haupttext 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 Sie etwas anfordern, das der Beschreibung einer Skill entspricht, liest Claude SKILL.md über Bash aus dem Dateisystem. Erst dann gelangt dieser Inhalt in das Kontextfenster.

Ebene 3: Ressourcen und Code (bei 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 bieten deterministische Operationen ohne Kontextverbrauch

Ressourcen: Referenzmaterialien wie Datenbankschemas, API-Dokumentation, Vorlagen oder Beispiele

Claude greift auf diese Dateien nur zu, wenn sie referenziert werden. Das Dateisystemmodell bedeutet, dass jeder Inhaltstyp unterschiedliche Stärken hat: Anweisungen für flexible Anleitung, Code für Zuverlässigkeit, Ressourcen für faktische Nachschlagwerke.

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 Dateisystemzugriff, Bash-Befehle und Code-Ausführungsfunktionen hat. Stellen Sie sich das so vor: Skills existieren als Verzeichnisse auf einer virtuellen Maschine, und Claude interagiert mit ihnen mit den gleichen Bash-Befehlen, die Sie verwenden würden, um auf Ihrem Computer durch Dateien zu navigieren.

Wie Claude auf Skill-Inhalte zugreift:

Wenn eine Skill ausgelöst wird, verwendet Claude Bash, um SKILL.md aus dem Dateisystem zu lesen und ihre Anweisungen in das Kontextfenster zu bringen. Wenn diese Anweisungen auf andere Dateien verweisen (wie FORMS.md oder ein Datenbankschema), liest Claude diese Dateien auch mit zusätzlichen 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:

On-Demand-Dateizugriff: Claude liest nur die Dateien, die für jede spezifische Aufgabe erforderlich sind. Eine Skill kann Dutzende von Referenzdateien enthalten, aber wenn Ihre Aufgabe nur das Verkaufsschema benötigt, lädt Claude nur diese eine Datei. Der Rest bleibt im Dateisystem und verbraucht null Token.

Effiziente Skriptausführung: Wenn Claude validate_form.py ausführt, gelangt der Code des Skripts nie in das Kontextfenster. Nur die Ausgabe des Skripts (wie "Validierung bestanden" oder spezifische Fehlermeldungen) verbraucht Token. Dies macht Skripte viel effizienter, als wenn Claude äquivalenten Code spontan generieren würde.

Keine praktische Grenze für gebündelte Inhalte: Da Dateien keinen Kontext verbrauchen, bis sie zugegriffen werden, können Skills umfassende API-Dokumentation, große Datensätze, umfangreiche Beispiele oder alle benötigten Referenzmaterialien enthalten. Es gibt keine Kontextstrafe für gebündelte Inhalte, die nicht verwendet werden.

Dieses dateisystembasierte Modell ist das, was progressive Offenlegung möglich macht. Claude navigiert durch Ihre Skill wie Sie spezifische Abschnitte eines Onboarding-Leitfadens referenzieren würden, und greift genau auf das zu, was jede Aufgabe erfordert.

Beispiel: Laden einer PDF-Verarbeitungs-Skill

Hier ist, wie Claude eine PDF-Verarbeitungs-Skill lädt und verwendet:

1. Start: System-Prompt enthält: PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Benutzeranfrage: "Extract the text from this PDF and summarize it"
3. Claude ruft auf: bash: read pdf-skill/SKILL.md → Anweisungen in Kontext geladen
4. Claude bestimmt: Formularausfüllung ist nicht erforderlich, daher wird FORMS.md nicht gelesen
5. Claude führt aus: Verwendet Anweisungen aus SKILL.md, um die Aufgabe abzuschließen

Das Diagramm zeigt:

1. Standardzustand mit System-Prompt und vorgeladenem Skill-Metadaten
2. Claude löst die Skill aus, indem er SKILL.md über Bash liest
3. Claude liest optional zusätzliche gebündelte Dateien wie FORMS.md bei Bedarf
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 über alle Claude-Agent-Produkte verfügbar:

Claude API

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

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

• code-execution-2025-08-25 - Skills laufen im Code-Ausführungs-Container
• skills-2025-10-02 - Aktiviert Skills-Funktionalität
• files-api-2025-04-14 - Erforderlich zum Hochladen/Herunterladen von Dateien in/aus dem Container

Verwenden Sie vorgefertigte Agent Skills, indem Sie auf ihre skill_id verweisen (z. B. pptx, xlsx), oder erstellen und laden Sie Ihre eigenen über die Skills API (/v1/skills Endpunkte) hoch. Benutzerdefinierte Skills werden organisationsweit geteilt.

Weitere Informationen finden Sie unter Use Skills with the Claude API.

Claude Code

Claude Code unterstützt nur benutzerdefinierte Skills.

Benutzerdefinierte Skills: Erstellen Sie Skills als Verzeichnisse mit SKILL.md-Dateien. Claude entdeckt und verwendet sie automatisch.

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

Weitere Informationen finden Sie unter Use Skills in Claude Code.

Claude Agent SDK

Das Claude Agent SDK unterstützt benutzerdefinierte Skills durch dateisystembasierte Konfiguration.

Benutzerdefinierte Skills: Erstellen Sie Skills als Verzeichnisse mit SKILL.md-Dateien in .claude/skills/. Aktivieren Sie Skills, indem Sie "Skill" in Ihre allowed_tools-Konfiguration aufnehmen.

Skills im Agent SDK werden dann automatisch erkannt, wenn das SDK ausgeführt wird.

Weitere Informationen finden Sie unter Agent Skills in the SDK.

Claude.ai

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

Vorgefertigte Agent Skills: Diese Skills funktionieren bereits im Hintergrund, wenn Sie Dokumente erstellen. Claude verwendet sie, ohne dass eine Einrichtung erforderlich ist.

Benutzerdefinierte Skills: Laden Sie Ihre eigenen Skills als ZIP-Dateien über Einstellungen > Funktionen hoch. Verfügbar in Pro-, Max-, Team- und Enterprise-Plänen mit aktivierter Code-Ausführung. Benutzerdefinierte Skills sind individuell für jeden Benutzer; sie werden nicht organisationsweit geteilt und können nicht zentral von Administratoren verwaltet werden.

Weitere Informationen zur Verwendung von Skills in Claude.ai finden Sie in den folgenden Ressourcen im Claude Help Center:

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

Skill-Struktur

Jede Skill erfordert 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]

Erforderliche Felder: name und description

Feldanforderungen:

name:

• Maximal 64 Zeichen
• Darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten
• Darf keine XML-Tags enthalten
• Darf keine reservierten Wörter enthalten: "anthropic", "claude"

description:

• Darf nicht leer sein
• Maximal 1024 Zeichen
• Darf keine XML-Tags enthalten

Die description sollte sowohl enthalten, was die Skill tut, als auch wann Claude sie verwenden sollte. Für vollständige Autorenanleitungen siehe den Best-Practices-Leitfaden.

Sicherheitsüberlegungen

Wir empfehlen dringend, Skills nur aus vertrauenswürdigen Quellen zu verwenden: solche, die Sie selbst erstellt haben, oder solche, die Sie von Anthropic erhalten haben. Skills statten Claude mit neuen Funktionen durch Anweisungen und Code aus, und während dies sie leistungsstark macht, bedeutet es auch, dass eine böswillige Skill Claude anweisen kann, Tools aufzurufen oder Code auf Weise auszuführen, die nicht dem angegebenen Zweck der Skill entspricht.

Wichtigste Sicherheitsüberlegungen:

• Gründlich überprüfen: Überprüfen Sie alle in der Skill gebündelten Dateien: SKILL.md, Skripte, Bilder und andere Ressourcen. Suchen Sie nach ungewöhnlichen Mustern wie unerwarteten Netzwerkaufrufen, Dateizugriffsmustern oder Operationen, die nicht dem angegebenen Zweck der Skill entsprechen
• Externe Quellen sind riskant: Skills, die Daten von externen URLs abrufen, bergen besonderes Risiko, da abgerufene Inhalte böswillige Anweisungen enthalten können. Selbst vertrauenswürdige Skills können kompromittiert werden, wenn sich ihre externen Abhängigkeiten im Laufe der Zeit ändern
• Missbrauch von Tools: Böswillige Skills können Tools (Dateivorgänge, Bash-Befehle, Code-Ausführung) auf schädliche Weise aufrufen
• Datenverlust: Skills mit Zugriff auf sensible Daten könnten so konzipiert sein, dass sie Informationen an externe Systeme durchsickern lassen
• Behandeln Sie es wie die Installation von Software: Verwenden Sie Skills nur aus vertrauenswürdigen Quellen. Seien Sie besonders vorsichtig, wenn Sie Skills in Produktionssysteme mit Zugriff auf sensible Daten oder kritische Operationen integrieren

Verfügbare Skills

Vorgefertigte Agent Skills

Die folgenden vorgefertigten Agent Skills sind sofort verfügbar:

• PowerPoint (pptx): Erstellen Sie Präsentationen, bearbeiten Sie Folien, analysieren Sie Präsentationsinhalte
• Excel (xlsx): Erstellen Sie Tabellenkalkulationen, analysieren Sie Daten, generieren Sie Berichte mit Diagrammen
• Word (docx): Erstellen Sie Dokumente, bearbeiten Sie Inhalte, formatieren Sie Text
• PDF (pdf): Generieren Sie formatierte PDF-Dokumente und Berichte

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

Beispiele für benutzerdefinierte Skills

Für vollständige Beispiele von benutzerdefinierten Skills siehe das Skills Cookbook.

Einschränkungen und Beschränkungen

Das Verständnis dieser Einschränkungen hilft Ihnen, Ihre Skills-Bereitstellung effektiv zu planen.

Verfügbarkeit über Oberflächen hinweg

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

• Skills, die auf Claude.ai hochgeladen werden, müssen separat auf die API hochgeladen werden
• Skills, die über die API hochgeladen werden, sind auf Claude.ai nicht verfügbar
• Claude Code Skills sind dateisystembasiert und separat von Claude.ai und API

Sie müssen Skills separat für jede Oberfläche verwalten und hochladen, auf der Sie sie verwenden möchten.

Freigabebereich

Skills haben je nach Verwendungsort unterschiedliche Freigabemodelle:

• Claude.ai: Nur einzelner Benutzer; jedes Teammitglied muss separat hochladen
• Claude API: Arbeitsbereich-weit; alle Arbeitsbereichsmitglieder können hochgeladene Skills zugreifen
• Claude Code: Persönlich (~/.claude/skills/) oder projektbasiert (.claude/skills/); kann auch über Claude Code Plugins geteilt werden

Claude.ai unterstützt derzeit keine zentralisierte Admin-Verwaltung oder organisationsweite Verteilung von benutzerdefinierten Skills.

Laufzeitumgebungsbeschränkungen

Die genaue Laufzeitumgebung, die Ihrer Skill zur Verfügung steht, hängt von der Produktoberfläche ab, auf der Sie sie verwenden.

• Claude.ai:
  • Unterschiedlicher Netzwerkzugriff: Je nach Benutzer-/Admin-Einstellungen können Skills vollständigen, teilweisen oder keinen Netzwerkzugriff haben. Weitere Details finden Sie im Support-Artikel Create and Edit Files.
• Claude API:
  • Kein Netzwerkzugriff: Skills können keine externen API-Aufrufe tätigen oder auf das Internet zugreifen
  • Keine Laufzeit-Paketinstallation: Nur vorinstallierte Pakete sind verfügbar. Sie können während der Ausführung keine neuen Pakete installieren.
  • Nur vorkonfigurierte Abhängigkeiten: Überprüfen Sie die Code-Ausführungs-Tool-Dokumentation für die Liste der verfügbaren Pakete
• Claude Code:
  • Vollständiger Netzwerkzugriff: Skills haben den gleichen Netzwerkzugriff wie jedes andere Programm auf dem Computer des Benutzers
  • Globale Paketinstallation nicht empfohlen: Skills sollten Pakete nur lokal installieren, um zu vermeiden, dass der Computer des Benutzers beeinträchtigt wird

Planen Sie Ihre Skills so, dass sie innerhalb dieser Einschränkungen funktionieren.

Nächste Schritte