Agent Skills



Warum Skills verwenden

Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die Claude domänenspezifische Expertise verleihen: Workflows, Kontext und Best Practices, die einen Allzweck-Agenten in einen Spezialisten verwandeln. Im Gegensatz zu Prompts (Anweisungen auf Gesprächsebene für einmalige Aufgaben) werden Skills bei Bedarf geladen, sodass du dieselben Anleitungen nicht über mehrere Gespräche hinweg wiederholen musst.

Wichtigste Vorteile:

• Claude spezialisieren: Fähigkeiten für domänenspezifische Aufgaben maßschneidern
• Wiederholungen reduzieren: Einmal erstellen, automatisch verwenden
• Fähigkeiten kombinieren: Skills für komplexe, mehrstufige Aufgaben kombinieren



Skills verwenden

Anthropic stellt vorgefertigte Agent Skills für gängige Dokumentaufgaben bereit (PowerPoint, Excel, Word, PDF), und du kannst deine eigenen benutzerdefinierten Skills erstellen. Beide funktionieren auf die gleiche Weise: Sobald ein Skill in deiner Umgebung verfügbar ist, verwendet Claude ihn automatisch, wenn er für deine Anfrage relevant ist.

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, Domänenexpertise 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 Onboarding-Leitfaden, den du für ein neues Teammitglied erstellen würdest.

Diese dateisystembasierte Architektur ermöglicht progressive Offenlegung (progressive disclosure): Claude lädt Informationen stufenweise nach Bedarf, anstatt den Kontext von vornherein zu belegen.

Skills können drei Arten von Inhalten enthalten, die jeweils zu einem anderen Zeitpunkt geladen werden:



Ebene 1: Metadaten (immer geladen)

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 nimmt sie in den System-Prompt auf. Die description ist das, womit Claude deine Anfrage abgleicht, um zu bestimmen, ob der Skill ausgelöst werden soll. Sie muss daher sowohl angeben, was der Skill tut, als auch, wann er verwendet werden soll. Dieser leichtgewichtige Ansatz bedeutet, dass du viele Skills installieren kannst, ohne Kontext zu verlieren: Bis ein Skill ausgelöst wird, belegen nur sein Name und seine Beschreibung Kontext.



Ebene 2: Anweisungen (geladen bei Auslösung)

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



Ebene 3: Ressourcen und Code (geladen nach Bedarf)

Skills können zusätzliche Materialien bündeln:

pdf-processing/
├── 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 mit bash ausführt und die deterministische Operationen ermöglichen, ohne ihren Code in den Kontext zu laden

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

Claude greift nur dann 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 faktische Nachschlagewerke.

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ührungsfähigkeiten hat. Skills existieren als Verzeichnisse auf einer virtuellen Maschine, und Claude interagiert mit ihnen über dieselben bash-Befehle, die du zum Navigieren von 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 Skript-Code selbst gelangt nie in den Kontext).

Was diese Architektur ermöglicht:

• Dateizugriff bei Bedarf: Claude liest nur die Dateien, die jede Aufgabe benötigt. Ein Skill kann Dutzende von Referenzdateien enthalten, aber wenn deine Aufgabe nur das Vertriebsschema benötigt, ist das die eine Datei, die Claude lädt. Der Rest bleibt im Dateisystem und kostet null Token.
• Effiziente Skript-Ausführung: Wenn Claude validate_form.py ausführt, wird der Code des Skripts nie in das Kontextfenster geladen. Nur seine Ausgabe (wie „Validation passed" oder eine spezifische Fehlermeldung) verbraucht Token, was Skripte weitaus effizienter macht, als wenn Claude äquivalenten Code spontan generieren würde.
• Keine praktische Begrenzung für gebündelte Inhalte: Dateien verbrauchen keinen Kontext, bis auf sie zugegriffen wird, sodass Skills umfassende API-Dokumentation, große Datensätze oder umfangreiche Beispiele enthalten können. Es gibt keine Kontext-Kosten für gebündelte Inhalte, die nicht verwendet werden.



Beispiel: Laden eines PDF-Verarbeitungs-Skills

So lädt und verwendet Claude den benutzerdefinierten pdf-processing-Skill aus den früheren Beispielen (nicht den vorgefertigten pdf-Skill):

1. Start: Der System-Prompt enthält: pdf-processing - 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.
2. Benutzeranfrage: „Extrahiere den Text aus dieser PDF und fasse ihn zusammen"
3. Claude ruft auf: bash: cat pdf-processing/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



Wo Skills funktionieren

Skills sind in allen Agenten-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 relevante skill_id im container-Parameter zusammen mit dem Code-Ausführungs-Tool an.

Voraussetzungen: Die Verwendung von Skills über die API erfordert das Code-Ausführungs-Tool, in dessen Container Skills laufen, und einen Beta-Header:

• skills-2025-10-02 - Aktiviert die Skills-Funktionalität

Füge einen zweiten Header, files-api-2025-04-14, hinzu, wenn du die Files API verwendest, um Eingabedateien in den Container hochzuladen oder Dateien herunterzuladen, die ein Skill erzeugt.

Verwende vorgefertigte Agent Skills, indem du ihre skill_id referenzierst (pptx, xlsx, docx oder pdf), 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 auf sie zugreifen.

Skills auf der API laufen in einem sandboxed Container ohne Netzwerkzugriff und ohne Paketinstallation zur Laufzeit. Siehe Einschränkungen und Beschränkungen für Details.

Um mehr zu erfahren, siehe Agent Skills mit der API verwenden.



Claude Code

Claude Code unterstützt benutzerdefinierte Skills. Die vorgefertigten Dokument-Skills (PowerPoint, Excel, Word, PDF) sind in Claude Code nicht verfügbar, allerdings ist der Open-Source-Claude API Skill darin enthalten. Siehe die vollständige Liste der integrierten Befehle und Skills, die mit Claude Code ausgeliefert werden.

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: Lege sie in ~/.claude/skills/ (persönlich) oder .claude/skills/ (Projekt) ab.

Um mehr zu erfahren, siehe Skills in Claude Code verwenden.



claude.ai

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

Vorgefertigte Agent Skills: Diese Skills sind aktiv, wenn du Dokumente erstellst. Claude verwendet sie ohne erforderliche Einrichtung.

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.

Um mehr über die Verwendung von Skills in claude.ai zu erfahren, siehe die 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 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]

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 muss sowohl angeben, was der Skill tut, als auch, wann Claude ihn verwenden soll. Vollständige Anleitungen zum Erstellen findest du unter Best Practices für das Erstellen von Skills.



Sicherheitsüberlegungen

Verwende Skills nur aus vertrauenswürdigen Quellen: solche, die du selbst erstellt oder von Anthropic erhalten hast. Skills geben Claude neue Fähigkeiten durch Anweisungen und Code, was auch bedeutet, 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 gestaltet sein, dass sie Informationen an externe Systeme weitergeben
• Wie die Installation von Software behandeln: Sei besonders vorsichtig, wenn du Skills in Produktionssysteme mit Zugriff auf sensible Daten oder kritische Operationen integrierst

Für Governance, Prüfung und Bereitstellung im Organisationsmaßstab siehe Skills für Unternehmen.



Verfügbare Skills



Vorgefertigte Agent Skills

Die folgenden vorgefertigten Agent Skills stehen zur sofortigen Verwendung zur Verfügung:

• 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. 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 Skill: Stellt Claude aktuelles API-Referenzmaterial, SDK-Dokumentation und Best Practices für acht Programmiersprachen bereit. Mit Claude Code gebündelt und 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.



Datenspeicherung

Agent Skills fällt nicht unter ZDR-Vereinbarungen. Skill-Definitionen und Ausführungsdaten werden gemäß der Standard-Datenspeicherungsrichtlinie von Anthropic aufbewahrt.

Für die ZDR-Berechtigung aller Funktionen siehe API und Datenspeicherung.



Einschränkungen und Beschränkungen

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

Verwalte und lade Skills separat für jede Oberfläche hoch, auf der du sie verwenden möchtest.



Freigabeumfang

Skills haben unterschiedliche Freigabemodelle, je nachdem, wo du sie verwendest:

• 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:
  • Variierender Netzwerkzugriff: Je nach Benutzer-/Admin-Einstellungen können Skills vollständigen, teilweisen oder keinen Netzwerkzugriff haben. Weitere Details findest du 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 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 wird nicht empfohlen: Skills sollten Pakete nur lokal installieren, um Beeinträchtigungen des Computers des Benutzers zu vermeiden.

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



Nächste Schritte