Agent Skills



Warum Skills verwenden

Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die Claude mit domänenspezifischem Fachwissen ausstatten: Workflows, Kontext und Best Practices, die universelle Agenten in Spezialisten verwandeln. Im Gegensatz zu Prompts (Anweisungen auf Konversationsebene für einmalige Aufgaben) werden Skills bei Bedarf geladen und machen es überflüssig, dieselben Anleitungen in mehreren Konversationen wiederholt bereitzustellen.

Wichtigste Vorteile:

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



Skills verwenden

Anthropic stellt vorgefertigte Agent Skills für gängige Dokumentaufgaben (PowerPoint, Excel, Word, PDF) bereit, und du kannst deine eigenen benutzerdefinierten Skills erstellen. Beide funktionieren auf die gleiche Weise. Claude verwendet sie automatisch, wenn sie für deine Anfrage relevant sind.

Vorgefertigte Agent Skills sind auf claude.ai, der Claude API, Claude Platform on AWS und Microsoft Foundry verfügbar. Auf Microsoft Foundry erfordern Agent Skills ein Hosted on Anthropic Deployment. Siehe Verfügbare Skills für die vollständige Liste.

Benutzerdefinierte Skills ermöglichen es dir, Fachwissen und organisatorisches Wissen zu bündeln. Sie sind in allen Claude-Produkten verfügbar: Erstelle sie in Claude Code, lade sie über die Claude API hoch oder füge sie in den claude.ai-Einstellungen hinzu. Auf Claude Platform on AWS und Microsoft Foundry lädst du benutzerdefinierte Skills über die Skills API hoch.



Wie Skills funktionieren

Skills nutzen Claudes VM-Umgebung, um Fähigkeiten bereitzustellen, die über das hinausgehen, was mit Prompts allein möglich ist. Claude arbeitet in einer virtuellen Maschine mit Dateisystemzugriff, wodurch Skills als Verzeichnisse existieren können, die Anweisungen, ausführbaren Code und Referenzmaterialien enthalten – organisiert wie ein Einarbeitungsleitfaden, den du für ein neues Teammitglied erstellen würdest.

Diese dateisystembasierte Architektur ermöglicht progressive disclosure (schrittweise Offenlegung): Claude lädt Informationen stufenweise nach Bedarf, anstatt von Anfang an Kontext zu verbrauchen.



Drei Arten von Skill-Inhalten, drei Ladestufen

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



Stufe 1: Metadaten (immer geladen)

Inhaltstyp: Anweisungen. Das YAML-Frontmatter des Skills 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 fügt sie in den System-Prompt ein. Dieser schlanke Ansatz bedeutet, dass du viele Skills installieren kannst, ohne das Kontextfenster zu belasten; Claude weiß nur, dass jeder Skill existiert und wann er verwendet werden soll.



Stufe 2: Anweisungen (geladen bei Auslösung)

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 du etwas anforderst, das zur Beschreibung eines Skills passt, liest Claude SKILL.md über bash aus dem Dateisystem. Erst dann gelangt dieser Inhalt in das Kontextfenster.



Stufe 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 spezialisierten Anleitungen 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 nur auf diese Dateien 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 faktisches Nachschlagen.

Progressive Disclosure 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ührungsfähigkeiten hat. Stell es dir so vor: Skills existieren als Verzeichnisse auf einer virtuellen Maschine, und Claude interagiert mit ihnen über dieselben bash-Befehle, die du zum Navigieren durch Dateien auf deinem Computer verwenden würdest.

Wie Claude auf Skill-Inhalte zugreift:

Wenn ein Skill ausgelöst wird, verwendet Claude bash, um SKILL.md aus dem Dateisystem zu lesen und dessen 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:

Dateizugriff bei Bedarf: Claude liest nur die Dateien, die für jede spezifische Aufgabe benötigt werden. Ein Skill kann Dutzende von Referenzdateien enthalten, aber wenn deine Aufgabe nur das Vertriebsschema 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, wird der Code des Skripts nie in das Kontextfenster geladen. Nur die Ausgabe des Skripts (wie „Validierung bestanden" oder spezifische Fehlermeldungen) verbraucht Token. Das macht Skripte weitaus effizienter, als wenn Claude äquivalenten Code spontan generieren müsste.

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

Dieses dateisystembasierte Modell macht Progressive Disclosure erst möglich. Claude navigiert durch deinen Skill, so wie du bestimmte Abschnitte eines Einarbeitungsleitfadens nachschlagen würdest, und greift genau auf das zu, was jede Aufgabe erfordert.



Beispiel: Laden eines PDF-Verarbeitungs-Skills

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

1. Start: Der 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 vorab geladenem System-Prompt und Skill-Metadaten
2. Claude löst den Skill aus, indem SKILL.md über bash gelesen wird
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: Gib die entsprechende skill_id im container-Parameter 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 die Skills-Funktionalität
• files-api-2025-04-14 – Erforderlich zum Hoch-/Herunterladen von Dateien in/aus dem Container

Verwende vorgefertigte Agent Skills, indem du ihre skill_id referenzierst (zum Beispiel pptx, xlsx), oder erstelle und lade deine eigenen über die Skills API (/v1/skills-Endpunkte) hoch. Benutzerdefinierte Skills werden workspace-weit geteilt; alle Workspace-Mitglieder können darauf zugreifen.

Weitere Informationen findest du 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.

Weitere Informationen findest du 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 dass eine Einrichtung erforderlich ist.

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

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

• Was sind Skills?
• Skills in Claude verwenden
• Wie man benutzerdefinierte Skills erstellt
• Bringe Claude deine Arbeitsweise mit Skills bei



Skill-Struktur

Jeder 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 1024 Zeichen
• Darf keine XML-Tags enthalten

Die description sollte sowohl beschreiben, was der Skill tut, als auch wann Claude ihn verwenden sollte. Vollständige Anleitungen zum Erstellen findest du im Best-Practices-Leitfaden.



Sicherheitsüberlegungen

Verwende nur Skills aus vertrauenswürdigen Quellen: solche, die du selbst erstellt oder von Anthropic erhalten hast. Skills statten Claude durch Anweisungen und Code mit neuen Fähigkeiten aus, und obwohl sie dadurch leistungsstark sind, bedeutet das auch, dass ein bösartiger Skill Claude anweisen kann, Tools aufzurufen oder Code auf eine Weise auszuführen, die nicht dem angegebenen Zweck des Skills entspricht.

Wichtige Sicherheitsüberlegungen:

• Gründlich prüfen: Überprüfe alle im Skill gebündelten Dateien: SKILL.md, Skripte, Bilder und andere Ressourcen. Achte auf ungewöhnliche Muster wie unerwartete Netzwerkaufrufe, Dateizugriffsmuster oder Operationen, die nicht dem angegebenen Zweck des Skills 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 so konzipiert sein, dass sie Informationen an externe Systeme weitergeben
• Wie Software-Installation behandeln: Verwende nur Skills aus vertrauenswürdigen Quellen. Sei besonders vorsichtig, wenn du Skills in Produktionssysteme mit Zugriff auf sensible Daten oder kritische Operationen integrierst



Verfügbare Skills



Vorgefertigte Agent Skills

Die folgenden vorgefertigten Agent Skills sind sofort einsatzbereit:

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

Diese Skills sind auf der Claude API, Claude Platform on AWS, Microsoft Foundry und claude.ai verfügbar. Auf Microsoft Foundry erfordern Agent Skills ein Hosted on Anthropic Deployment. Siehe das Schnellstart-Tutorial, um sie in der API zu verwenden.



Open-Source-Skills

Anthropic veröffentlicht auch Open-Source-Skills im Skills-Repository:

• Claude API: Stellt Claude aktuelles API-Referenzmaterial, SDK-Dokumentation und Best Practices für 8 Programmiersprachen bereit. Wird mit Claude Code ausgeliefert und ist auch zur Installation aus dem Skills-Repository verfügbar.



Beispiele für benutzerdefinierte Skills

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



Datenaufbewahrung

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

Informationen zur ZDR-Eignung für alle Funktionen findest du unter API und Datenaufbewahrung.



Einschränkungen und Beschränkungen

Das Verständnis dieser Einschränkungen hilft dir, deine Skills-Bereitstellung effektiv zu planen. Claude Platform on AWS und Microsoft Foundry unterliegen in den folgenden Unterabschnitten denselben Einschränkungen wie die Claude API.



Verfügbarkeit über Oberflächen hinweg

Benutzerdefinierte Skills werden nicht über Oberflächen hinweg synchronisiert. Skills, die auf einer 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 getrennt von claude.ai und der API

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



Freigabebereich

Skills haben je nach Verwendungsort unterschiedliche Freigabemodelle:

• claude.ai: Nur individueller Benutzer; jedes Teammitglied muss separat hochladen
• Claude API: Workspace-weit; alle Workspace-Mitglieder können auf 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 keine zentralisierte Admin-Verwaltung oder organisationsweite Verteilung von benutzerdefinierten Skills.



Einschränkungen der Laufzeitumgebung

Die genaue Laufzeitumgebung, die deinem Skill zur Verfügung steht, hängt von der Produktoberfläche ab, auf der du ihn verwendest.

• claude.ai:
  • Unterschiedlicher Netzwerkzugriff: Abhängig von Benutzer-/Admin-Einstellungen können Skills vollständigen, teilweisen oder keinen Netzwerkzugriff haben. Weitere Details findest du im Support-Artikel Dateien mit Claude erstellen und bearbeiten.
• Claude API:
  • Kein Netzwerkzugriff: Skills können keine externen API-Aufrufe tätigen oder auf das Internet zugreifen
  • Keine Paketinstallation zur Laufzeit: Nur vorinstallierte Pakete sind verfügbar. Du kannst während der Ausführung keine neuen Pakete installieren.
  • Nur vorkonfigurierte Abhängigkeiten: Siehe die Dokumentation zum Code-Ausführungs-Tool für die Liste der verfügbaren Pakete
• Claude Code:
  • Vollständiger Netzwerkzugriff: Skills haben denselben Netzwerkzugriff wie jedes andere Programm auf dem Computer des Benutzers
  • Globale Paketinstallation nicht empfohlen: Skills sollten Pakete nur lokal installieren, um Beeinträchtigungen des Benutzercomputers zu vermeiden

Plane deine Skills so, dass sie innerhalb dieser Einschränkungen funktionieren.



Nächste Schritte