Agent Skills

Warum Skills verwenden

Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die Claude domänenspezifisches Fachwissen verleihen: Workflows, Kontext und Best Practices, die einen Allzweck-Agenten in einen Spezialisten verwandeln. Anders als Prompts (Anweisungen auf Gesprächsebene für einmalige Aufgaben) werden Skills bei Bedarf geladen, sodass du dieselben Vorgaben nicht in jedem Gespräch wiederholen musst.

Wichtigste Vorteile:

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

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 dieselbe 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, in der Claude API, auf der Claude Platform on AWS und in Microsoft Foundry verfügbar. In Microsoft Foundry erfordern Agent Skills ein Hosted on Anthropic-Deployment. Die vollständige Liste findest du unter Verfügbare Skills.

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

Wie Skills funktionieren

Skills nutzen die VM-Umgebung von Claude, um Fähigkeiten bereitzustellen, die über das hinausgehen, was mit Prompts allein möglich ist. 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 Onboarding-Leitfaden, 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 den Kontext im Voraus zu verbrauchen.

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

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

Stufe 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 anforderst, das zur Beschreibung eines Skills passt, liest Claude SKILL.md mithilfe von bash aus dem Dateisystem. Erst dann gelangt dieser Inhalt in das „context window" (Kontextfenster).

Stufe 3: Ressourcen und Code (bei Bedarf geladen)

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

• pdf-processing/
  • SKILL.md (Hauptanweisungen)
  • FORMS.md (Leitfaden zum Ausfüllen von Formularen)
  • REFERENCE.md (detaillierte API-Referenz)
  • scripts/
    • fill_form.py (Hilfsskript)

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 mithilfe von bash ausführt und die deterministische Operationen bereitstellen, ohne ihren Code in den Kontext zu laden

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

Claude greift nur auf diese Dateien zu, wenn auf sie verwiesen wird. Das Dateisystemmodell bedeutet, dass jeder Inhaltstyp unterschiedliche Stärken hat: Anweisungen für flexible Anleitung, Code für Zuverlässigkeit, Ressourcen für das Nachschlagen von Fakten.

Die schrittweise 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 bringt so dessen Anweisungen in das Kontextfenster. 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 jede Aufgabe benötigt. Ein Skill kann Dutzende von Referenzdateien enthalten, aber wenn deine Aufgabe nur das Vertriebsschema benötigt, ist das die einzige Datei, die Claude lädt. Der Rest bleibt im Dateisystem und kostet null Token.
• Effiziente Skriptausfü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 bestimmte Fehlermeldung) verbraucht Token, was Skripte weitaus effizienter macht, als wenn Claude gleichwertigen 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. Für gebündelte Inhalte, die nicht verwendet werden, gibt es keinen Kontextnachteil.

Beispiel: Laden eines Skills zur PDF-Verarbeitung

So lädt und verwendet Claude den benutzerdefinierten pdf-processing-Skill aus den vorherigen 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 diesem 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: Das Ausfüllen von Formularen ist nicht erforderlich, daher wird FORMS.md nicht gelesen
5. Claude führt aus: Verwendet die Anweisungen aus SKILL.md, um die Aufgabe zu erledigen

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 relevante skill_id im Parameter container zusammen mit dem Code-Ausführungstool an.

Voraussetzungen: Die Verwendung von Skills über die API erfordert das Code-Ausführungstool, in dessen Container Skills ausgeführt werden.

Verwende vorgefertigte Agent Skills, indem du auf ihre skill_id (pptx, xlsx, docx oder pdf) verweist, oder erstelle und lade deine eigenen über die Skills API (/v1/skills-Endpunkte) hoch. Benutzerdefinierte Skills werden workspaceweit geteilt: Alle Workspace-Mitglieder können darauf zugreifen.

Skills in der API laufen in einem Sandbox-Container ohne Netzwerkzugriff und ohne Paketinstallation zur Laufzeit. Details findest du unter Einschränkungen und Beschränkungen.

Weitere Informationen findest du unter 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. Sieh dir die vollständige Liste der integrierten Befehle und Skills an, 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.

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 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 für jeden Benutzer individuell. 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 den folgenden Ressourcen im Claude Help Center:

• Was sind Skills?
• Skills in Claude verwenden
• Benutzerdefinierte Skills erstellen
• Claude mit Skills deine Arbeitsweise beibringen

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]

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

Sicherheitsüberlegungen

Verwende Skills nur aus vertrauenswürdigen Quellen: solche, die du selbst erstellt oder von Anthropic erhalten hast. Skills verleihen Claude durch Anweisungen und Code neue Fähigkeiten, was auch bedeutet, dass ein bösartiger Skill Claude dazu bringen 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, Codeausfü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 Softwareinstallation behandeln: Sei besonders vorsichtig, wenn du Skills in Produktionssysteme mit Zugriff auf sensible Daten oder kritische Operationen integrierst

Hinweise zu Governance, Prüfung und Bereitstellung im Organisationsmaßstab findest du unter Skills für Unternehmen. Claude Enterprise-Organisationen können außerdem das Scannen von Skill-Inhalten für benutzerdefinierte Skills aktivieren, die in claude.ai und Claude Cowork hochgeladen werden. Das Scannen umfasst keine Skills, die über die Skills API oder die Claude Console hochgeladen werden.

Verfügbare Skills

Vorgefertigte Agent Skills

Die folgenden vorgefertigten Agent Skills stehen zur sofortigen Verwendung bereit:

• 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 in der Claude API, auf der Claude Platform on AWS, in Microsoft Foundry und auf claude.ai verfügbar. Sieh dir das Schnellstart-Tutorial an, um sie in der API zu verwenden.

Open-Source-Skills

Anthropic veröffentlicht außerdem Open-Source-Skills im Skills-Repository:

• Claude API Skill: Stellt Claude aktuelles API-Referenzmaterial, SDK-Dokumentation und Best Practices für acht Programmiersprachen bereit. Wird mit Claude Code mitgeliefert 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 ist nicht durch ZDR-Vereinbarungen abgedeckt. Skill-Definitionen und Ausführungsdaten werden gemäß der Standardrichtlinie von Anthropic zur Datenaufbewahrung aufbewahrt.

Zur ZDR-Berechtigung aller Funktionen siehe API und Datenaufbewahrung.

Zur Audit-Protokollierung von Skills-API-Operationen siehe Audit-Protokollierung in „Agent Skills mit der API verwenden“.

Einschränkungen und Beschränkungen

Claude Platform on AWS und Microsoft Foundry unterliegen in den folgenden Unterabschnitten denselben Einschränkungen wie die Claude API. Darüber hinaus wird in Microsoft Foundry der Endpunkt zum Herunterladen von Skill-Versionen (GET /v1/skills/{skill_id}/versions/{version}/content) nicht unterstützt.

Oberflächenübergreifende Verfügbarkeit

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

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

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

Freigabebereich

Skills haben je nach Verwendungsort unterschiedliche Freigabemodelle:

• claude.ai: Nur einzelner 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 zentrale Admin-Verwaltung oder organisationsweite Verteilung benutzerdefinierter 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: Je nach Benutzer-/Admin-Einstellungen können Skills vollen, teilweisen oder keinen Netzwerkzugriff haben. Weitere Details findest du 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 Paketinstallation zur Laufzeit: Nur vorinstallierte Pakete sind verfügbar. Du kannst während der Ausführung keine neuen Pakete installieren.
  • Nur vorkonfigurierte Abhängigkeiten: Die Liste der verfügbaren Pakete findest du in der Dokumentation zum Codeausführungstool.
• Claude Code:
  • Voller 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 den Computer des Benutzers nicht zu beeinträchtigen.

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

Nächste Schritte