MessagesSkills

Erste Schritte mit Agent Skills in der API

Erfahre, 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 dem Stellen von API-Anfragen

Überblick über Agent Skills

Vorgefertigte Agent Skills erweitern die Fähigkeiten von Claude 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

Möchtest du eigene Skills erstellen? Im Agent Skills Cookbook findest du Beispiele für das Erstellen eigener Skills mit domänenspezifischem Fachwissen.

Schritt 1: Verfügbare Skills auflisten

Überprüfe zunächst, welche Skills verfügbar sind. Verwende die Skills API, um alle von Anthropic verwalteten Skills aufzulisten:

# Von Anthropic verwaltete Skills auflisten
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 (schrittweisen Offenlegung), bei der Claude Skills entdeckt, ohne bereits deren vollständige Anweisungen 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=["code-execution-2025-08-25", "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_20250825", "name": "code_execution"}],
)

print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Schauen wir uns an, was die einzelnen Teile bewirken:

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

Die Beispiele hier verwenden die Tool-Version code_execution_20250825 mit dem dazugehörigen Beta-Header code-execution-2025-08-25. Skills funktionieren auch mit den neueren Revisionen des Code-Execution-Tools (code_execution_20260120 und später); jede Version des Code-Execution-Tools erfüllt die Anforderung für Skills. Unabhängig davon, welche Version du verwendest, halte den Tool-type und den 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 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-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-Ausführungs-Tools. Der Skill führt
# seine Arbeit ggf. über das Python- oder das Bash-Code-Ausführungs-Tool aus, 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=["code-execution-2025-08-25", "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_20250825", "name": "code_execution"}],
)

Ein Word-Dokument erstellen

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "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_20250825", "name": "code_execution"}],
)

Ein PDF generieren

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "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_20250825", "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

Erfahre, 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 dem Stellen von 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? Im Agent Skills Cookbook findest du Beispiele für das Erstellen eigener Skills mit domänenspezifischem Fachwissen.

Schritt 1: Verfügbare Skills auflisten

Überprüfe zunächst, welche Skills verfügbar sind. Verwende die Skills API, um alle von Anthropic verwalteten Skills aufzulisten:

# Von Anthropic verwaltete Skills auflisten
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=["code-execution-2025-08-25", "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_20250825", "name": "code_execution"}],
)

print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Schauen wir uns an, was die einzelnen Teile bewirken:

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

Schritt 3: Die erstellte Datei herunterladen

# Extrahiere die Datei-ID aus dem Ergebnis des Code-Ausführungs-Tools. Der Skill führt
# seine Arbeit ggf. über das Python- oder das Bash-Code-Ausführungs-Tool aus, 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=["code-execution-2025-08-25", "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_20250825", "name": "code_execution"}],
)

Ein Word-Dokument erstellen

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "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_20250825", "name": "code_execution"}],
)

Ein PDF generieren

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "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_20250825", "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