MessagesSkills

Erste Schritte mit Agent Skills in der API

Lerne, wie du Agent Skills verwendest, um in weniger als 10 Minuten Dokumente mit der Claude API 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 einfache Anfrage stellst und auf die generierte Datei zugreifst.

Voraussetzungen

Claude API-Key
Python 3.7+ oder curl installiert
Grundlegende Vertrautheit mit 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

Möchtest du eigene Skills erstellen? Siehe das Agent Skills Cookbook für Beispiele zum Erstellen eigener Skills mit domänenspezifischer Expertise.

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:

# Liste die von Anthropic verwalteten Skills auf
ant beta: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 wissen, 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 nun den PowerPoint-Skill, um eine Präsentation über erneuerbare Energien zu erstellen. Gib Skills über den container-Parameter in der Messages API an:

# Erstelle eine Nachricht mit dem PowerPoint-Skill
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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)}")

Schauen wir uns an, was jeder Teil bewirkt:

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 Codeausführung (erforderlich für Skills)
Beta-Header: skills-2025-10-02

Die Beispiele hier verwenden die Tool-Version code_execution_20260521, die allgemein verfügbar ist und keinen Beta-Header für die Codeausführung erfordert. Skills funktionieren auch mit älteren Versionen des Code-Execution-Tools (wie code_execution_20250825); jede Version des Code-Execution-Tools erfüllt die Skills-Anforderung. Welche Version du auch verwendest, halte deren Tool-type und etwaige Beta-Header konsistent mit der Seite zum Code-Execution-Tool und füge immer skills-2025-10-02 hinzu.

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-Execution-Container erstellt und als Datei gespeichert. Die Antwort enthält eine Dateireferenz mit einer Datei-ID. Extrahiere die Datei-ID und lade sie über die Files API herunter:

# Extrahiere die Datei-ID aus dem Ergebnis des Code-Execution-Tools. Der Skill kann
# seine Arbeit entweder über das Python- oder das Bash-Code-Execution-Tool ausführen,
# prüfe daher beide Ergebnistypen.
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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.beta.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Vollständige Details zum Arbeiten mit generierten Dateien findest du in der Dokumentation zum Code-Execution-Tool.

Weitere Beispiele ausprobieren

Nachdem du nun dein erstes Dokument mit Skills erstellt hast, probiere diese Varianten aus:

Eine Tabellenkalkulation erstellen

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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-4-8",
    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-4-8",
    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

Nachdem du nun vorgefertigte Agent Skills verwendet hast, kannst du:

API-Leitfaden

Skills mit der Claude API verwenden

Eigene Skills erstellen

Lade deine eigenen Skills für spezialisierte Aufgaben hoch

Leitfaden zum Erstellen

Lerne Best Practices für das Schreiben effektiver Skills

Skills in Claude Code verwenden

Erfahre mehr über Skills in Claude Code

Agent Skills Cookbook

Erkunde Beispiel-Skills und Implementierungsmuster

Was this page helpful?

MessagesSkills

Erste Schritte mit Agent Skills in der API

Lerne, wie du Agent Skills verwendest, um in weniger als 10 Minuten Dokumente mit der Claude API zu erstellen.

Voraussetzungen

Claude API-Key
Python 3.7+ oder curl installiert
Grundlegende Vertrautheit mit API-Anfragen

Überblick über Agent Skills

PowerPoint (pptx): Präsentationen erstellen und bearbeiten
Excel (xlsx): Tabellenkalkulationen erstellen und analysieren
Word (docx): Dokumente erstellen und bearbeiten
PDF (pdf): PDF-Dokumente generieren

Möchtest du eigene Skills erstellen? Siehe das Agent Skills Cookbook für Beispiele zum Erstellen eigener Skills mit domänenspezifischer Expertise.

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:

# Liste die von Anthropic verwalteten Skills auf
ant beta:skills list --source anthropic

Du siehst die folgenden Skills: pptx, xlsx, docx und pdf.

Schritt 2: Eine Präsentation erstellen

Verwende nun den PowerPoint-Skill, um eine Präsentation über erneuerbare Energien zu erstellen. Gib Skills über den container-Parameter in der Messages API an:

# Erstelle eine Nachricht mit dem PowerPoint-Skill
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["skills-2025-10-02"],
    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)}")

Schauen wir uns an, was jeder Teil bewirkt:

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 Codeausführung (erforderlich für Skills)
Beta-Header: skills-2025-10-02

Schritt 3: Die erstellte Datei herunterladen

# Extrahiere die Datei-ID aus dem Ergebnis des Code-Execution-Tools. Der Skill kann
# seine Arbeit entweder über das Python- oder das Bash-Code-Execution-Tool ausführen,
# prüfe daher beide Ergebnistypen.
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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.beta.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Vollständige Details zum Arbeiten mit generierten Dateien findest du in der Dokumentation zum Code-Execution-Tool.

Weitere Beispiele ausprobieren

Nachdem du nun dein erstes Dokument mit Skills erstellt hast, probiere diese Varianten aus:

Eine Tabellenkalkulation erstellen

response = client.beta.messages.create(
    model="claude-opus-4-8",
    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-4-8",
    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-4-8",
    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

Nachdem du nun vorgefertigte Agent Skills verwendet hast, kannst du:

API-Leitfaden

Skills mit der Claude API verwenden

Eigene Skills erstellen

Lade deine eigenen Skills für spezialisierte Aufgaben hoch

Leitfaden zum Erstellen

Lerne Best Practices für das Schreiben effektiver Skills

Skills in Claude Code verwenden

Erfahre mehr über Skills in Claude Code

Agent Skills Cookbook

Erkunde Beispiel-Skills und Implementierungsmuster

Was this page helpful?

Voraussetzungen

Überblick über Agent Skills

Schritt 1: Verfügbare Skills auflisten

Schritt 2: Eine Präsentation erstellen

Schritt 3: Die erstellte Datei herunterladen

Weitere Beispiele ausprobieren

Eine Tabellenkalkulation erstellen

Ein Word-Dokument erstellen

Ein PDF generieren

Nächste Schritte

Voraussetzungen

Überblick über Agent Skills

Schritt 1: Verfügbare Skills auflisten

Schritt 2: Eine Präsentation erstellen

Schritt 3: Die erstellte Datei herunterladen

Weitere Beispiele ausprobieren

Eine Tabellenkalkulation erstellen

Ein Word-Dokument erstellen

Ein PDF generieren

Nächste Schritte

Voraussetzungen

Überblick über Agent Skills

Schritt 1: Verfügbare Skills auflisten

Schritt 2: Eine Präsentation erstellen

Schritt 3: Die erstellte Datei herunterladen

Weitere Beispiele ausprobieren

Eine Tabellenkalkulation erstellen

Ein Word-Dokument erstellen

Ein PDF generieren

Nächste Schritte

Voraussetzungen

Überblick über Agent Skills

Schritt 1: Verfügbare Skills auflisten

Schritt 2: Eine Präsentation erstellen

Schritt 3: Die erstellte Datei herunterladen

Weitere Beispiele ausprobieren

Eine Tabellenkalkulation erstellen

Ein Word-Dokument erstellen

Ein PDF generieren

Nächste Schritte