Skills

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.

• Vorgefertigte Anthropic-Skills: Gängige Dokumentaufgaben wie die Verarbeitung von PowerPoint, Excel, Word und PDF (pptx, xlsx, docx, pdf).
• Benutzerdefinierte Skills: Skills, die du selbst erstellst und in deinen Workspace hochlädst.

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.



Einen benutzerdefinierten Skill erstellen

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.

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

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.



Skills an einen Agenten anhängen

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:

ant 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
YAML



Nächste Schritte