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 kommen 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 sowohl Anthropic als auch 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.
Wie es funktioniert:
- Skills erstellen Dateien während der Code-Ausführung
- Die Antwort enthält
file_id
fü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.
Multi-Turn-Konversationen
Verwenden Sie denselben Container über mehrere Nachrichten hinweg wieder, indem Sie die Container-ID angeben:Langwierige Operationen
Skills können Operationen ausführen, die mehrere Turns erfordern. Behandeln Siepause_turn
Stop-Gründe:
Die Antwort kann einen
pause_turn
Stop-Grund enthalten, der anzeigt, dass die API eine langwierige Skill-Operation unterbrochen hat. Sie können die Antwort in einer nachfolgenden Anfrage unverändert zurückgeben, um Claude seinen Turn 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 einzelnen Anfrage, um komplexe Workflows zu handhaben: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:
name
(maximal 64 Zeichen),description
(maximal 1024 Zeichen)
Skills auflisten
Rufen Sie alle Skills ab, die in Ihrem Workspace verfügbar sind, einschließlich sowohl vorgefertigter Anthropic Skills als auch 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 zunächst 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 veröffentlicht, wenn Updates vorgenommen werden
- Geben Sie exakte 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 System-Eingabeaufforderung
- 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 kombinieren sich für komplexe Workflows
Anwendungsfälle
Organisatorische Skills
Marke & Kommunikation- Wenden Sie unternehmensweite Formatierung (Farben, Schriftarten, Layouts) auf Dokumente an
- Generieren Sie Kommunikationen nach organisatorischen Vorlagen
- Stellen Sie sicher, dass Markenrichtlinien konsistent über alle Ausgaben hinweg sind
- Strukturieren Sie Notizen mit unternehmensweiten Formaten (OKRs, Entscheidungsprotokolle)
- Generieren Sie Aufgaben nach Team-Konventionen
- Erstellen Sie standardisierte Meeting-Zusammenfassungen und Status-Updates
- Erstellen Sie unternehmensstandard-Berichte, Vorschläge und Analysen
- Führen Sie unternehmensweite analytische Verfahren aus
- Generieren Sie Finanzmodelle nach organisatorischen Vorlagen
Persönliche Skills
Content-Erstellung- Benutzerdefinierte Dokumentvorlagen
- Spezialisierte Formatierung und Styling
- Domänenspezifische Content-Generierung
- Benutzerdefinierte Datenverarbeitungs-Pipelines
- Spezialisierte Visualisierungsvorlagen
- Branchenspezifische analytische Methoden
- Code-Generierungs-Vorlagen
- Test-Frameworks
- Deployment-Workflows
Beispiel: Finanzmodellierung
Kombinieren Sie Excel und benutzerdefinierte DCF-Analyse Skills:Grenzen und Einschränkungen
Request-Grenzen
- Maximale Skills pro Anfrage: 8
- Maximale Skill-Upload-Größe: 8 MB (alle Dateien kombiniert)
- YAML-Frontmatter-Grenzen:
name
64 Zeichen,description
1024 Zeichen
Umgebungseinschränkungen
Skills werden im Code-Ausführungs-Container mit diesen Einschränkungen ausgeführt:- Kein Netzwerkzugriff - Kann keine externen API-Aufrufe tätigen
- Keine Runtime-Paketinstallation - Nur vorinstallierte Pakete verfügbar
- Isolierte Umgebung - Jede Anfrage erhält einen frischen Container
Best Practices
Wann mehrere Skills verwendet werden
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)