Für die vollständige API-Referenz einschließlich Request/Response-Schemas und aller Parameter siehe:
- Skill Management API Reference - CRUD-Operationen für Skills
- Skill Versions API Reference - Versionsverwaltung
Quick Links
Erste Schritte mit Agent Skills
Erstellen Sie Ihren ersten Skill
Benutzerdefinierte Skills erstellen
Best Practices zum Verfassen von Skills
Übersicht
Für einen tieferen Einblick in die Architektur und reale Anwendungen von Agent Skills lesen Sie unseren Engineering-Blog: Equipping agents for the real world with Agent Skills.
container-Struktur.
Skills verwenden
Skills integrieren sich unabhängig von der Quelle identisch in die Messages API. Sie geben Skills imcontainer-Parameter mit einer skill_id, einem type und einer optionalen version an, und sie werden in der Code-Ausführungsumgebung ausgeführt.
Sie können Skills aus zwei Quellen verwenden:
| Aspekt | Anthropic Skills | Benutzerdefinierte Skills |
|---|---|---|
| Type-Wert | anthropic | custom |
| Skill-IDs | Kurznamen: pptx, xlsx, docx, pdf | Generiert: skill_01AbCdEfGhIjKlMnOpQrStUv |
| Versionsformat | Datumsbasiert: 20251013 oder latest | Epoch-Zeitstempel: 1759178010641129 oder latest |
| Verwaltung | Vorgefertigt und von Anthropic gepflegt | Hochladen und Verwalten über Skills API |
| Verfügbarkeit | Für alle Benutzer verfügbar | Privat für Ihren Workspace |
source-Parameter zum Filtern). Die Integrationsform und die Ausführungsumgebung sind identisch – der einzige Unterschied ist, woher die Skills stammen und wie sie verwaltet werden.
Voraussetzungen
Um Skills zu verwenden, benötigen Sie:- Anthropic API-Schlüssel aus der Console
- Beta-Header:
code-execution-2025-08-25- Aktiviert Code-Ausführung (erforderlich für Skills)skills-2025-10-02- Aktiviert Skills APIfiles-api-2025-04-14- Zum Hochladen/Herunterladen von Dateien zum/vom Container
- Code-Ausführungs-Tool in Ihren Anfragen aktiviert
Skills in Messages verwenden
Container-Parameter
Skills werden mit demcontainer-Parameter in der Messages API angegeben. Sie können bis zu 8 Skills pro Anfrage einschließen.
Die Struktur ist für Anthropic und benutzerdefinierte Skills identisch – geben Sie den erforderlichen type und die skill_id an und schließen Sie optional version ein, um an eine bestimmte Version gebunden zu sein:
Heruntergeladene generierte Dateien
Wenn Skills Dokumente erstellen (Excel, PowerPoint, PDF, Word), geben siefile_id-Attribute in der Antwort zurück. Sie müssen die Files API verwenden, um diese Dateien herunterzuladen.
So funktioniert es:
- Skills erstellen Dateien während der Code-Ausführung
- Die Antwort enthält
file_idfür jede erstellte Datei - Verwenden Sie die Files API, um den tatsächlichen Dateiinhalt herunterzuladen
- Speichern Sie lokal oder verarbeiten Sie nach Bedarf
Für vollständige Details zur Files API siehe die Files API-Dokumentation.
Mehrteilige Konversationen
Verwenden Sie denselben Container über mehrere Nachrichten hinweg, indem Sie die Container-ID angeben:Langfristige Operationen
Skills können Operationen durchführen, die mehrere Durchläufe erfordern. Behandeln Siepause_turn-Stoppgründe:
Die Antwort kann einen
pause_turn-Stoppgrund enthalten, der anzeigt, dass die API eine langfristige Skill-Operation unterbrochen hat. Sie können die Antwort in einer nachfolgenden Anfrage unverändert bereitstellen, um Claude seinen Durchlauf fortsetzen zu lassen, oder Sie können den Inhalt ändern, wenn Sie das Gespräch unterbrechen und zusätzliche Anleitung geben möchten.Mehrere Skills verwenden
Kombinieren Sie mehrere Skills in einer einzigen Anfrage, um komplexe Workflows zu bewältigen:Benutzerdefinierte Skills verwalten
Einen Skill erstellen
Laden Sie Ihren benutzerdefinierten Skill hoch, um ihn in Ihrem Workspace verfügbar zu machen. Sie können entweder einen Verzeichnispfad oder einzelne Dateiobjekte hochladen.- Muss eine SKILL.md-Datei auf der obersten Ebene enthalten
- Alle Dateien müssen ein gemeinsames Stammverzeichnis in ihren Pfaden angeben
- Die Gesamtgröße des Uploads muss unter 8 MB liegen
- YAML-Frontmatter-Anforderungen:
name: Maximal 64 Zeichen, nur Kleinbuchstaben/Zahlen/Bindestriche, keine XML-Tags, keine reservierten Wörter (“anthropic”, “claude”)description: Maximal 1024 Zeichen, nicht leer, keine XML-Tags
Skills auflisten
Rufen Sie alle Skills ab, die für Ihren Workspace verfügbar sind, einschließlich vorgefertigter Anthropic Skills und Ihrer benutzerdefinierten Skills. Verwenden Sie densource-Parameter zum Filtern nach Skill-Typ:
Einen Skill abrufen
Rufen Sie Details zu einem bestimmten Skill ab:Einen Skill löschen
Um einen Skill zu löschen, müssen Sie zuerst alle seine Versionen löschen:Versionierung
Skills unterstützen Versionierung, um Updates sicher zu verwalten: Von Anthropic verwaltete Skills:- Versionen verwenden Datumsformat:
20251013 - Neue Versionen werden als Updates veröffentlicht
- Geben Sie genaue Versionen für Stabilität an
- Automatisch generierte Epoch-Zeitstempel:
1759178010641129 - Verwenden Sie
"latest", um immer die neueste Version zu erhalten - Erstellen Sie neue Versionen beim Aktualisieren von Skill-Dateien
Wie Skills geladen werden
Wenn Sie Skills in einem Container angeben:- Metadaten-Erkennung: Claude sieht Metadaten für jeden Skill (Name, Beschreibung) in der Systemaufforderung
- Datei-Laden: Skill-Dateien werden in den Container unter
/skills/{directory}/kopiert - Automatische Verwendung: Claude lädt und verwendet Skills automatisch, wenn sie für Ihre Anfrage relevant sind
- Komposition: Mehrere Skills arbeiten zusammen für komplexe Workflows
Anwendungsfälle
Organisatorische Skills
Marke & Kommunikation- Wenden Sie unternehmensspezifische Formatierung (Farben, Schriftarten, Layouts) auf Dokumente an
- Generieren Sie Kommunikationen nach Organisationsvorlagen
- Stellen Sie sicher, dass Markenrichtlinien in allen Ausgaben konsistent sind
- Strukturieren Sie Notizen mit unternehmensspezifischen Formaten (OKRs, Entscheidungsprotokolle)
- Generieren Sie Aufgaben nach Team-Konventionen
- Erstellen Sie standardisierte Besprechungsnotizen und Statusaktualisierungen
- Erstellen Sie unternehmensstandard-Berichte, Vorschläge und Analysen
- Führen Sie unternehmensspezifische analytische Verfahren durch
- Generieren Sie Finanzmodelle nach Organisationsvorlagen
Persönliche Skills
Inhaltserstellung- Benutzerdefinierte Dokumentvorlagen
- Spezialisierte Formatierung und Gestaltung
- Domänenspezifische Inhaltsgenerierung
- Benutzerdefinierte Datenverarbeitungs-Pipelines
- Spezialisierte Visualisierungsvorlagen
- Branchenspezifische analytische Methoden
- Code-Generierungsvorlagen
- Test-Frameworks
- Bereitstellungs-Workflows
Beispiel: Finanzmodellierung
Kombinieren Sie Excel und benutzerdefinierte DCF-Analyse-Skills:Limits und Einschränkungen
Anfrage-Limits
- Maximale Skills pro Anfrage: 8
- Maximale Skill-Upload-Größe: 8 MB (alle Dateien zusammen)
- YAML-Frontmatter-Anforderungen:
name: Maximal 64 Zeichen, nur Kleinbuchstaben/Zahlen/Bindestriche, keine XML-Tags, keine reservierten Wörterdescription: Maximal 1024 Zeichen, nicht leer, keine XML-Tags
Umgebungseinschränkungen
Skills werden im Code-Ausführungs-Container mit diesen Einschränkungen ausgeführt:- Kein Netzwerkzugriff - Können keine externen API-Aufrufe tätigen
- Keine Laufzeit-Paketinstallation - Nur vorinstallierte Pakete verfügbar
- Isolierte Umgebung - Jede Anfrage erhält einen neuen Container
Best Practices
Wann mehrere Skills verwendet werden sollten
Kombinieren Sie Skills, wenn Aufgaben mehrere Dokumenttypen oder Domänen betreffen: Gute Anwendungsfälle:- Datenanalyse (Excel) + Präsentationserstellung (PowerPoint)
- Berichtsgenerierung (Word) + Export zu PDF
- Benutzerdefinierte Domänenlogik + Dokumentgenerierung
- Einschließen ungenutzter Skills (beeinträchtigt die Leistung)