Claude Platform Docs
MessagesSkills

Agent Skills

Agent Skills sind modulare Fähigkeiten, die die Funktionalität von Claude erweitern. Jeder Skill bündelt Anweisungen, Metadaten und optionale Ressourcen (Skripte, Vorlagen), die Claude automatisch verwendet, wenn sie relevant sind.

Nutzung unterscheidet sich je nach Produkt

Messages API
Führe type und skill_id jedes Skills in container.skills auf und füge das Code-Ausführungstool hinzu, in dessen Container die Skills ausgeführt werden.
Managed Agents
Hänge Skills im Array skills des Agenten an oder lade sie aus einem GitHub-Repository, das in der Sitzung eingebunden ist.

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 und auf einigen Cloud-Plattformen verfügbar. Die Liste der Skills findest du unter Verfügbare Skills.

Benutzerdefinierte Skills ermöglichen es dir, Domänenexpertise und Organisationswissen zu bündeln. Erstelle sie in Claude Code, lade sie über die Skills API hoch oder füge sie in den Einstellungen von claude.ai hinzu.

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 bei Bedarf in Stufen, anstatt den Kontext von vornherein 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 dass ihr Code in den Kontext geladen wird

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 Anleitungen, Code für Zuverlässigkeit, Ressourcen zum Nachschlagen von Fakten.

StufeWann geladenToken-KostenInhalt
Stufe 1: MetadatenImmer (beim Start)~100 Token pro Skillname und description aus dem YAML-Frontmatter
Stufe 2: AnweisungenWenn der Skill ausgelöst wirdUnter 5k TokenSKILL.md-Hauptteil mit Anweisungen und Anleitungen
Stufe 3+: RessourcenBei BedarfKeine, bis darauf zugegriffen wirdGebündelte Dateien. Referenzdateien werden beim Lesen in den Kontext geladen. Skripte werden über bash ausgeführt, und nur ihre Ausgabe gelangt in den Kontext.

Die schrittweise Offenlegung stellt sicher, dass zu jedem Zeitpunkt nur relevante Inhalte das Kontextfenster belegen.

Die Skills-Architektur

Skills laufen in einer Codeausführungsumgebung, in der Claude Dateisystemzugriff, bash-Befehle und Codeausführungsfähigkeiten hat. Skills existieren als Verzeichnisse auf einer virtuellen Maschine, und Claude interagiert mit ihnen über dieselben bash-Befehle, die du zum Navigieren in Dateien auf deinem Computer verwenden würdest.

Agent + Skills + Computer
Zentraler System-Prompt
bigquerydocxnda-reviewpdfpptxxlsx
MCP-Server 1
MCP-Server 2
MCP-Server 3
MCP-Server 1
MCP-Server 2
MCP-Server 3
Computer verwenden
BashPythonNodejs
Skill-Verzeichnisse liegen im Dateisystem des Agent-Computers
skills/bigquery/SKILL.mddatasources.mdrules.mdskills/docx/SKILL.mdooxml/spec.mdediting.mdskills/nda-review/SKILL.mdskills/pdf/SKILL.mdforms.mdreference.mdextract_fields.py

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 diese über bash aus und erhält nur die Ausgabe (der Skriptcode selbst gelangt nie in den Kontext).

Was diese Architektur möglich macht:

  • 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 (etwa „Validation passed“ oder eine bestimmte Fehlermeldung) verbraucht Token, was Skripte weitaus effizienter macht, als wenn Claude während der Aufgabe gleichwertigen Code generiert.
  • 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 keine Kontext-Einbußen.

Beispiel: Laden eines PDF-Verarbeitungs-Skills

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 wird nicht benötigt, daher liest Claude FORMS.md nicht.
  5. Claude schließt die Aufgabe ab: Verwendet die Anweisungen aus SKILL.md.
Skills und das Kontextfenster
<...contents of the agent’s core system prompt...>
Kurze Ausschnitte aus jedem Skill, an den System-Prompt angehängt
bigquerydocxnda-reviewpdfpptxxlsx
Erste Nachricht vom Benutzer
User: Fill out this PDF based on what you know about meAttached: /mnt/uploads/order_form.pdf
Claude entscheidet, den PDF-Skill durch Lesen „auszulösen“
Claude: Certainly! I’ll use the PDF Skill to helpTool use: Bash (”cat /mnt/skills/pdf/SKILL.md”)
Tool result: {stdout: “...contents of the SKILL.md file...”}
Claude entscheidet, dem Verweis von SKILL.md auf die Datei forms.md zu folgen
Tool use: Bash (”cat /mnt/skills/pdf/forms.md”)
Tool result: {stdout: “...contents of the forms.md file...”}

Wo Skills funktionieren

Skills sind in allen Agent-Produkten von Claude verfügbar. Informationen zu Claude Managed Agents findest du auf der zugehörigen Seite Skills.

Die Details zur Claude API auf dieser Seite gelten auch auf den Cloud-Plattformen, die Skills anbieten. Die Ausnahmen findest du unter Freigabebereich und im Eintrag deiner Plattform unter Verfügbarkeit.

Claude API

Die Claude API unterstützt sowohl vorgefertigte Agent Skills als auch benutzerdefinierte Skills. Beide funktionieren identisch: Gib für jeden Skill type und skill_id in container.skills 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. Wie benutzerdefinierte Skills geteilt werden, erfährst du unter Freigabebereich.

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 hoch. Verfügbar in den Plänen Pro, Max, Ultra, Team und Enterprise mit aktivierter Codeausführung.

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

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, Ziffern 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 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 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önnten. 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.
  • Datenpreisgabe: 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.

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

Um sie zu verwenden, sieh dir Erste Schritte mit Agent Skills in der API an.

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 Agent 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 Audit-Protokollierung von Skills-API-Operationen siehe Audit-Protokollierung in „Agent Skills mit der API verwenden“.

Einschränkungen und Beschränkungen

Prüfe diese Einschränkungen, bevor du einen Skill erstellst oder teilst. Prüfe auf einer Cloud-Plattform außerdem den Eintrag deiner Plattform unter Verfügbarkeit auf etwaige Hosting- oder Endpunkt-Einschränkungen.

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:

  • Auf claude.ai hochgeladene Skills müssen separat in die API hochgeladen werden.
  • Über die API hochgeladene Skills sind auf 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 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 Models on Google Cloud (Anthropic managed): Jeder Skill gehört zu einem Workspace. Eine IAM-Rolle gilt für jeden Workspace im Google Cloud-Projekt, daher trennen Workspaces nicht, wer Skills lesen, verwenden oder verwalten kann. Für getrennten Zugriff verwende separate Projekte, wie unter Workspaces in Claude Models on Google Cloud (Anthropic managed) beschrieben.

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 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: In der Dokumentation zum Code-Ausführungstool findest du 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

Lerne, wie du mit Agent Skills in weniger als 10 Minuten Dokumente mit der Claude API erstellst.

Lerne, wie du mit Agent Skills die Fähigkeiten von Claude über die API erweiterst.

Erstelle und verwalte benutzerdefinierte Skills in Claude Code.

Lerne, wie du effektive Skills schreibst, die Claude erkennen und erfolgreich verwenden kann.

Verfügbarkeit

Agent Skills
APIs
  • Messages API
  • Managed Agents
Modelle
  • Alle Modelle

Zutreffende Endpunkte

  • /v1/skills
  • /v1/messages mit skills
Zero Data RetentionNicht berechtigt

Skill-Daten werden gemäß der Standardrichtlinie aufbewahrt. Mehr erfahren

HIPAANicht berechtigt

War diese Seite hilfreich?