Skills sind wiederverwendbare, dateisystembasierte Ressourcen, die deinem Agenten domänenspezifische Expertise verleihen: Workflows, Kontext und Best Practices, die einen Allzweck-Agenten in einen Spezialisten verwandeln. Im Gegensatz zu Prompts (Anweisungen auf Konversationsebene für einmalige Aufgaben) werden Skills bei Bedarf geladen und wirken sich nur dann auf das Kontextfenster aus, wenn sie benötigt werden.
Du kannst zwei Arten von Skills anhängen. Beide funktionieren auf die gleiche Weise: Dein Agent ruft sie automatisch auf, wenn sie für die Aufgabe relevant sind.
pptx, xlsx, docx, pdf).Um zu erfahren, wie du benutzerdefinierte Skills erstellst, siehe Agent Skills und Best Practices für die Skill-Erstellung. Um einen benutzerdefinierten Skill in deinen Workspace hochzuladen, siehe Einen benutzerdefinierten Skill erstellen.
Alle Managed Agents API-Anfragen erfordern den Beta-Header managed-agents-2026-04-01. Das SDK setzt den Beta-Header automatisch.
Ein benutzerdefinierter Skill ist ein Verzeichnis, das eine SKILL.md-Datei sowie alle unterstützenden Dateien enthält und als Zip-Archiv oder als einzelne Dateien in deinen Workspace hochgeladen wird. Beim Erstellen des Skills wird die skill_*-ID zurückgegeben, auf die du verweist, wenn du ihn an einen Agenten anhängst. Vorgefertigte Anthropic-Skills sind bereits in jedem Workspace verfügbar und erfordern diesen Schritt nicht. Wenn du nur vorgefertigte Skills verwenden möchtest, springe zu Skills an einen Agenten anhängen.
Wenn du die Skills API direkt mit cURL oder der CLI aufrufst, übergib den Header anthropic-beta: skills-2025-10-02 explizit. Die SDKs senden ihn automatisch.
In diesen Beispielen wird das optionale Feld display_title weggelassen, sodass der Titel des Skills aus SKILL.md abgeleitet wird. Ein explizit übergebener display_title muss unter den benutzerdefinierten Skills in deinem Workspace eindeutig sein.
Um benutzerdefinierte Skills aufzulisten, abzurufen, zu löschen und zu versionieren, siehe Benutzerdefinierte Skills verwalten. Die vollständigen Request- und Response-Schemata findest du in der Create Skill API-Referenz. Skill-Bundles werden direkt über die Skills API hochgeladen und nicht über die Files API.
Hänge Skills beim Erstellen eines Agenten an. Jede Session unterstützt insgesamt bis zu 20 Skills, gezählt über alle Agenten in der Session hinweg (siehe Multi-Agent-Sessions).
Jeder Eintrag im skills-Array verwendet die folgenden Felder:
| Feld | Beschreibung |
|---|---|
type | Entweder anthropic für vorgefertigte Skills oder custom für im Workspace erstellte Skills. |
skill_id | Die Skill-Kennung. Verwende für Anthropic-Skills den Kurznamen (zum Beispiel xlsx). Verwende für benutzerdefinierte Skills die skill_*-ID, die bei der Erstellung zurückgegeben wurde (siehe Einen benutzerdefinierten Skill erstellen). |
version | Nur für benutzerdefinierte Skills. Fixiere auf eine bestimmte Version oder verwende latest. Optional. Standardmäßig latest, wenn weggelassen. |
Passe Cloud-Sandboxes für deine Sessions an.
Erfahre, wie du Agent Skills verwendest, um die Fähigkeiten von Claude über die API zu erweitern.
Lade Dateien einmal hoch und referenziere sie über API-Anfragen hinweg.
Was this page helpful?
ant beta:skills create \
--file example_skill.zip \
--beta skills-2025-10-02ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
- type: anthropic
skill_id: xlsx
- type: custom
skill_id: skill_abc123
version: latest
YAMLErfahre, wie du Agent Skills verwendest, um in weniger als 10 Minuten Dokumente mit der Claude API zu erstellen.