Agent Skills

Warum Skills verwenden

Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die Claude domänenspezifisches Fachwissen bereitstellen: Workflows, Kontext und Best Practices, die universelle 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, dieselbe Anleitung in mehreren Gesprächen wiederholt bereitzustellen.

Wesentliche Vorteile:

• Claude spezialisieren: Fähigkeiten für domänenspezifische Aufgaben anpassen
• Wiederholung reduzieren: Einmal erstellen, automatisch verwenden
• Fähigkeiten kombinieren: Skills zusammenstellen, um komplexe Workflows zu erstellen

Skills verwenden

Anthropic stellt vorgefertigte Agent Skills für häufige Dokumentaufgaben (PowerPoint, Excel, Word, PDF) bereit, und Sie können eigene benutzerdefinierte Skills erstellen. Beide funktionieren auf dieselbe 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änenwissen und organisatorisches Wissen zu bündeln. Sie sind in allen Produkten von Claude 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 die VM-Umgebung von Claude, um Fähigkeiten bereitzustellen, die über das mit Prompts allein Mögliche hinausgehen. Claude arbeitet in einer virtuellen Maschine mit Dateisystemzugriff, sodass Skills als Verzeichnisse existieren können, die Anweisungen, ausführbaren Code und Referenzmaterialien enthalten – organisiert wie ein Einarbeitungsleitfaden, den Sie für ein neues Teammitglied erstellen würden.

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

Drei Arten von Skill-Inhalten, drei Ladeebenen

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

Ebene 1: Metadaten (immer geladen)

Inhaltstyp: Anweisungen. Das YAML-Frontmatter der Skill liefert 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 schlanke Ansatz bedeutet, dass Sie viele Skills installieren können, ohne Kontext zu verbrauchen; Claude weiß nur, dass jede Skill existiert und wann sie verwendet werden soll.

Ebene 2: Anweisungen (beim Auslösen geladen)

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

# 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 Kontext zu verbrauchen

Ressourcen: Referenzmaterialien wie Datenbankschemata, 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 Anleitungen, Code für Zuverlässigkeit, Ressourcen für faktische Nachschlagevorgänge.

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

Die Skills-Architektur

Skills laufen in einer Code-Ausführungsumgebung, in der Claude Dateisystemzugriff, bash-Befehle und Code-Ausführungsfähigkeiten hat. Stellen Sie es sich so vor: Skills existieren als Verzeichnisse auf einer virtuellen Maschine, und Claude interagiert mit ihnen mithilfe derselben bash-Befehle, die Sie zum Navigieren von Dateien auf Ihrem Computer verwenden würden.

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 auf andere Dateien verweisen (wie FORMS.md oder ein Datenbankschema), liest Claude diese Dateien ebenfalls 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:

Bedarfsgesteuerter Dateizugriff: Claude liest nur die Dateien, die für jede spezifische Aufgabe benötigt werden. 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 verbleibt im Dateisystem und verbraucht null Token.

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

Keine praktische Begrenzung 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, umfangreiche Beispiele oder beliebige Referenzmaterialien enthalten. Es gibt keine Kontextstrafe für gebündelte Inhalte, die nicht verwendet werden.

Dieses dateisystembasierte Modell ist es, was progressive Offenlegung ermöglicht. Claude navigiert Ihre Skill so, wie Sie bestimmte Abschnitte eines Einarbeitungsleitfadens nachschlagen würden, und greift genau auf das zu, was jede Aufgabe erfordert.

Beispiel: Laden einer PDF-Verarbeitungs-Skill

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

1. Start: System-Prompt enthält: PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Benutzeranfrage: "Extrahiere den Text aus dieser PDF und fasse ihn zusammen"
3. Claude ruft auf: bash: read pdf-skill/SKILL.md → Anweisungen werden in den Kontext geladen
4. Claude stellt fest: Formularausfüllung wird nicht benötigt, 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 vorgeladenem System-Prompt und Skill-Metadaten
2. Claude löst die Skill aus, indem es SKILL.md über bash liest
3. Claude liest optional zusätzliche gebündelte Dateien wie FORMS.md nach 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 in allen Agent-Produkten von Claude 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 container-Parameter zusammen mit dem Code-Ausführungstool an.

Voraussetzungen: Die Verwendung 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-/Herunterladen von Dateien in/aus dem Container

Verwenden Sie vorgefertigte Agent Skills, indem Sie auf ihre skill_id verweisen (zum Beispiel 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 Skills mit der Claude API verwenden.

Claude Code

Claude Code unterstützt nur benutzerdefinierte Skills.

Benutzerdefinierte Skills: Erstellen Sie 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.

Weitere Informationen finden Sie unter Skills in Claude Code verwenden.

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 Ihrer allowed_tools-Konfiguration einschließen.

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

Weitere Informationen finden Sie unter Agent Skills im SDK.

Claude.ai

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

Vorgefertigte Agent Skills: Diese Skills arbeiten 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 für Pro-, Max-, Team- und Enterprise-Pläne 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:

• Was sind Skills?
• Skills in Claude verwenden
• Wie man benutzerdefinierte Skills erstellt
• Claude Ihre Arbeitsweise mit Skills beibringen

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]

Pflichtfelder: 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 1.024 Zeichen
• Darf keine XML-Tags enthalten

Die description sollte sowohl beschreiben, was die Skill tut, als auch wann Claude sie verwenden soll. Eine vollständige Anleitung zur Erstellung finden Sie im Leitfaden für Best Practices.

Sicherheitsüberlegungen

Wir empfehlen dringend, Skills nur aus vertrauenswürdigen Quellen zu verwenden: solche, die Sie selbst erstellt haben oder von Anthropic erhalten haben. Skills stellen Claude neue Fähigkeiten durch Anweisungen und Code bereit, und obwohl dies sie leistungsfähig macht, bedeutet es auch, dass eine bösartige Skill Claude anweisen kann, Tools aufzurufen oder Code auf eine Weise auszuführen, die nicht dem angegebenen Zweck der Skill entspricht.

Wesentliche Sicherheitsüberlegungen:

• Gründlich prüfen: Überprüfen Sie alle in der Skill gebündelten Dateien: SKILL.md, Skripte, Bilder und andere Ressourcen. Achten Sie auf ungewöhnliche Muster wie unerwartete Netzwerkaufrufe, Dateizugriffsmuster oder Operationen, die nicht dem angegebenen Zweck der Skill entsprechen
• Externe Quellen sind riskant: Skills, die Daten von externen URLs abrufen, stellen ein besonderes Risiko dar, 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, Code-Ausführung) auf schädliche Weise aufrufen
• Datenoffenlegung: Skills mit Zugriff auf sensible Daten könnten darauf ausgelegt sein, Informationen an externe Systeme weiterzugeben
• Wie Software-Installation behandeln: 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 zur sofortigen Verwendung verfügbar:

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

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

Beispiele für benutzerdefinierte Skills

Vollständige Beispiele für benutzerdefinierte Skills finden Sie im Skills Cookbook.

Datenspeicherung

Agent Skills ist nicht durch ZDR-Vereinbarungen abgedeckt. Skill-Definitionen und Ausführungsdaten werden gemäß der Standard-Datenspeicherungsrichtlinie von Anthropic aufbewahrt.

Informationen zur ZDR-Berechtigung für alle Funktionen finden Sie unter API und Datenspeicherung.

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 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 auf Claude.ai nicht verfügbar
• Claude Code Skills sind dateisystembasiert und von Claude.ai und der API getrennt

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

Freigabeumfang

Skills haben je nach Verwendungsort unterschiedliche Freigabemodelle:

• Claude.ai: Nur für einzelne Benutzer; jedes Teammitglied muss separat hochladen
• Claude API: Arbeitsbereichsweit; alle Arbeitsbereichsmitglieder können hochgeladene Skills aufrufen
• 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:
  • Variabler Netzwerkzugriff: Abhängig von Benutzer-/Admin-Einstellungen können Skills vollen, teilweisen oder keinen Netzwerkzugriff haben. Weitere Details finden Sie im Support-Artikel Dateien erstellen und bearbeiten.
• 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 Dokumentation zum Code-Ausführungstool für die Liste der verfügbaren Pakete
• Claude Code:
  • : Skills haben denselben Netzwerkzugriff wie jedes andere Programm auf dem Computer des Benutzers

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

Nächste Schritte