Erste Schritte mit Agent Skills in der API

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.



Voraussetzungen

• Ein Claude API-Key oder eine angemeldete ant CLI
• Ein Client-SDK für deine Sprache, oder curl und jq
• Grundlegende Vertrautheit mit dem Stellen von API-Anfragen



Überblick über Agent Skills

Vorgefertigte Agent Skills erweitern Claudes Fähigkeiten mit spezialisierter Expertise 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. Jeder Sprach-Tab ist ein Auszug aus einem durchgehenden Skript, mit allen Imports und der Client-Einrichtung am Anfang:

# List Anthropic-managed Skills
ant skills list --source anthropic

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 Ebene der progressive disclosure (progressiven Offenlegung), bei der Claude Skills entdeckt, ohne deren vollständige Anweisungen bereits 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 container-Parameter in der Messages API an:

# Create a message with the PowerPoint Skill
response = client.messages.create(
    model="claude-opus-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 umfasst die folgenden Teile:

• model: Ein Modell, das das Code-Ausführungs-Tool unterstützt
• container.skills: Gibt an, welche Skills Claude verwenden kann
• type: "anthropic": Zeigt an, dass dies ein von Anthropic verwalteter Skill ist
• skill_id: "pptx": Der Bezeichner des PowerPoint-Skills
• version: "latest": Die Skill-Version, gesetzt auf die zuletzt veröffentlichte
• tools: Aktiviert die Code-Ausführung (erforderlich für Skills)
• Beta-Header: skills-2025-10-02

Wenn du diese Anfrage stellst, ordnet Claude deine Aufgabe automatisch dem relevanten 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 Ebene der progressiven 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ührungs-Container 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 in deinem temporären Systemverzeichnis:

# Extract the file ID. The code execution tool runs the Skill's code through
# its Bash sub-tool, and generated files appear as bash_code_execution_output
# items inside the bash_code_execution_tool_result block.
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:
    # Download the file and save it
    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.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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