Erste Schritte mit Agent Skills in der API
Erfahre, wie du Agent Skills verwendest, um mit der Claude API in weniger als 10 Minuten Dokumente zu erstellen.
Dieses Tutorial zeigt dir, wie du Agent Skills verwendest, um eine PowerPoint-Präsentation zu erstellen. Du lernst, wie du Skills aktivierst, eine Anfrage stellst und auf die generierte Datei zugreifst.
Bevor du beginnst
Du benötigst ein Client-SDK für deine Sprache oder curl und jq sowie grundlegende Vertrautheit mit dem Stellen von API-Anfragen.
Erstelle ein Claude Console-Konto
Registriere dich für ein Claude Console-Konto oder melde dich bei deinem bestehenden Konto an.
Wähle aus, wie du dich authentifizierst
Für die lokale Entwicklung wird die Anmeldung über die CLI empfohlen.
CLIAPI-Schlüssel
Installiere die CLI
brew install anthropics/tap/antFür Linux-Umgebungen lädst du das Release-Binary direkt herunter.
VERSION=2.12.0 OS=$(uname -s | tr '[:upper:]' '[:lower:]') case $(uname -m) in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \ | sudo tar -xz -C /usr/local/bin antAlle Releases findest du auf der GitHub-Releases-Seite.
Du kannst die CLI auch aus dem Quellcode mit
go installinstallieren, was Go 1.26.10 oder höher erfordert.go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installlegt die Binärdatei in$(go env GOPATH)/binab. Füge dieses Verzeichnis zu deinemPATHhinzu, falls es dort noch nicht enthalten ist:export PATH="$PATH:$(go env GOPATH)/bin"Melde dich an
ant auth loginSobald die Anmeldung abgeschlossen ist, übernehmen die SDKs und die CLI deine Anmeldedaten automatisch.
Erstelle einen API-Key
Erstelle einen API-Key in der Claude Console.
Setze die Umgebungsvariable
Die SDKs und die CLI lesen deinen Key aus
ANTHROPIC_API_KEY:export ANTHROPIC_API_KEY="your-api-key-here"
Um die CLI-Beispiele auszuführen, installiere die CLI:
brew install anthropics/tap/antFür Linux-Umgebungen lädst du das Release-Binary direkt herunter.
VERSION=2.12.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin antAlle Releases findest du auf der GitHub-Releases-Seite.
Du kannst die CLI auch aus dem Quellcode mit go install installieren, was Go 1.26.10 oder höher erfordert.
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install legt die Binärdatei in $(go env GOPATH)/bin ab. Füge dieses Verzeichnis zu deinem PATH hinzu, falls es dort noch nicht enthalten ist:
export PATH="$PATH:$(go env GOPATH)/bin"Überblick über Agent Skills
Vorgefertigte Agent Skills erweitern Claudes Fähigkeiten um spezialisiertes Fachwissen für Aufgaben wie das Erstellen von Dokumenten, das Analysieren von Daten und das Verarbeiten von Dateien. Anthropic stellt die folgenden vorgefertigten Agent Skills in der API bereit:
- PowerPoint (pptx): Präsentationen erstellen und bearbeiten
- Excel (xlsx): Tabellenkalkulationen erstellen und analysieren
- Word (docx): Dokumente erstellen und bearbeiten
- PDF (pdf): PDF-Dokumente generieren
Schritt 1: Verfügbare Skills auflisten
Prüfe zunächst, welche Skills verfügbar sind. Verwende die Skills API, um alle von Anthropic verwalteten Skills aufzulisten. Das Beispiel ist ein Auszug aus einem durchgehenden Skript, mit etwaigen Imports und der Client-Einrichtung am Anfang:
# Von Anthropic verwaltete Skills auflisten
skills = client.skills.list(source="anthropic")
for skill in skills.data:
print(f"{skill.id}: {skill.display_name}")Du siehst die folgenden Skills: pptx, xlsx, docx und pdf.
Diese API gibt die Metadaten jedes Skills zurück: seinen Namen und seine Beschreibung. Claude lädt diese Metadaten beim Start, um zu bestimmen, welche Skills verfügbar sind. Dies ist die erste Stufe der „progressive disclosure“ (schrittweisen Offenlegung), bei der Claude Skills entdeckt, ohne bereits ihre vollständigen Anweisungen zu laden.
Schritt 2: Eine Präsentation erstellen
Verwende den PowerPoint-Skill, um eine Präsentation über erneuerbare Energien zu erstellen. Gib Skills über den Parameter container in der Messages API an:
# Erstelle eine Nachricht mit dem PowerPoint-Skill
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Create a presentation about renewable energy with 5 slides",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)
print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")Die Anfrage enthält die folgenden Bestandteile:
model: Ein Modell, das das Code-Ausführungstool unterstütztcontainer.skills: Gibt an, welche Skills Claude verwenden kanntype: "anthropic": Zeigt an, dass es sich um einen von Anthropic verwalteten Skill handeltskill_id: "pptx": Die Kennung des PowerPoint-Skillsversion: "latest": Die Skill-Version, festgelegt auf die zuletzt veröffentlichtetools: Aktiviert die Code-Ausführung (für Skills erforderlich)
Wenn du diese Anfrage stellst, ordnet Claude deine Aufgabe automatisch dem passenden Skill zu. Da du nach einer Präsentation gefragt hast, stellt Claude fest, dass der PowerPoint-Skill relevant ist, und lädt dessen vollständige Anweisungen: die zweite Stufe der schrittweisen Offenlegung. Anschließend führt Claude den Code des Skills aus, um deine Präsentation zu erstellen.
Schritt 3: Die erstellte Datei herunterladen
Die Präsentation wurde im Code-Ausführungscontainer erstellt und als Datei gespeichert. Die response aus Schritt 2 enthält eine Dateireferenz mit einer Datei-ID. Extrahiere die Datei-ID und lade die Datei mit der Files API herunter. Das Beispiel speichert sie im temporären Verzeichnis deines Systems:
# Extrahiere die Datei-ID. Das Code-Ausführungstool führt den Code des Skills über
# sein Bash-Sub-Tool aus, und erzeugte Dateien erscheinen als bash_code_execution_output-
# Einträge innerhalb des bash_code_execution_tool_result-Blocks.
file_id = None
for block in response.content:
if block.type == "bash_code_execution_tool_result":
if block.content.type == "bash_code_execution_result":
for output in block.content.content:
file_id = output.file_id
if file_id:
# Lade die Datei herunter und speichere sie
output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
file_content = client.files.download(file_id=file_id)
file_content.write_to_file(output_path)
print(f"Presentation saved to {output_path}")Weitere Beispiele ausprobieren
Probiere diese Varianten aus:
Eine Tabellenkalkulation erstellen
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Create a quarterly sales tracking spreadsheet with sample data",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)Ein Word-Dokument erstellen
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Write a 2-page report on the benefits of renewable energy",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)Ein PDF generieren
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
container={
"skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
},
messages=[
{
"role": "user",
"content": "Generate a PDF invoice template",
}
],
tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)Nächste Schritte
Erfahre, wie du effektive Skills schreibst, die Claude entdecken und erfolgreich verwenden kann.
Erfahre, wie du Agent Skills verwendest, um Claudes Fähigkeiten über die API zu erweitern.
Lade deine eigenen Skills für spezialisierte Aufgaben hoch.
Erfahre mehr über Skills in Claude Code.
Entdecke Beispiel-Skills und Implementierungsmuster.
War diese Seite hilfreich?