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 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. Jeder Sprach-Tab ist ein Auszug aus einem durchgehenden Skript, mit allen 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ützt
• container.skills: Gibt an, welche Skills Claude verwenden kann
• type: "anthropic": Zeigt an, dass es sich um einen von Anthropic verwalteten Skill handelt
• skill_id: "pptx": Die Kennung des PowerPoint-Skills
• version: "latest": Die Skill-Version, festgelegt auf die zuletzt veröffentlichte
• tools: 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