Commencer avec les Agent Skills dans l'API

Ce tutoriel vous montre comment utiliser les Agent Skills pour créer une présentation PowerPoint. Vous apprendrez comment activer les Skills, faire une demande simple et accéder au fichier généré.

Prérequis

• Clé API Claude
• Python 3.7+ ou curl installé
• Familiarité de base avec les demandes d'API

Aperçu des Agent Skills

Les Agent Skills pré-construits étendent les capacités de Claude avec une expertise spécialisée pour des tâches comme créer des documents, analyser des données et traiter des fichiers. Anthropic fournit les Agent Skills pré-construits suivants dans l'API :

• PowerPoint (pptx) : Créer et éditer des présentations
• Excel (xlsx) : Créer et analyser des feuilles de calcul
• Word (docx) : Créer et éditer des documents
• PDF (pdf) : Générer des documents PDF

Étape 1 : Lister les Skills disponibles

D'abord, vérifiez quels Skills sont disponibles. Utilisez l'API Skills pour lister tous les Skills gérés par Anthropic :

ant beta:skills list --source anthropic

Vous voyez les Skills suivants : pptx, xlsx, docx et pdf.

Cette API retourne les métadonnées de chaque Skill : son nom et sa description. Claude charge ces métadonnées au démarrage pour savoir quels Skills sont disponibles. C'est le premier niveau de divulgation progressive, où Claude découvre les Skills sans charger encore leurs instructions complètes.

Étape 2 : Créer une présentation

Maintenant, utilisez le Skill PowerPoint pour créer une présentation sur l'énergie renouvelable. Spécifiez les Skills en utilisant le paramètre container dans l'API Messages :

import anthropic

client = anthropic.Anthropic()

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=4096,
    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(response.content)

Décomposons ce que chaque partie fait :

• container.skills : Spécifie quels Skills Claude peut utiliser
• type: "anthropic" : Indique qu'il s'agit d'un Skill géré par Anthropic
• skill_id: "pptx" : L'identifiant du Skill PowerPoint
• version: "latest" : La version du Skill définie sur la plus récemment publiée
• tools : Active l'exécution de code (requise pour les Skills)
• En-têtes Beta : code-execution-2025-08-25 et skills-2025-10-02

Quand vous faites cette demande, Claude fait automatiquement correspondre votre tâche au Skill pertinent. Puisque vous avez demandé une présentation, Claude détermine que le Skill PowerPoint est pertinent et charge ses instructions complètes : le deuxième niveau de divulgation progressive. Ensuite, Claude exécute le code du Skill pour créer votre présentation.

Étape 3 : Télécharger le fichier créé

La présentation a été créée dans le conteneur d'exécution de code et enregistrée en tant que fichier. La réponse inclut une référence de fichier avec un ID de fichier. Extrayez l'ID de fichier et téléchargez-le en utilisant l'API Files :

from typing import Any

response: Any = None
# Extract file ID from response
file_id = None
for block in response.content:
    if block.type == "tool_use" and block.name == "code_execution":
        # File ID is in the tool result
        for result_block in block.content:
            if hasattr(result_block, "file_id"):
                file_id = result_block.file_id
                break

if file_id:
    # Download the file
    file_content = client.beta.files.download(
        file_id=file_id, betas=["files-api-2025-04-14"]
    )

    # Save to disk
    with open("renewable_energy.pptx", "wb") as f:
        file_content.write_to_file(f.name)

    print(f"Presentation saved to renewable_energy.pptx")

Essayez plus d'exemples

Maintenant que vous avez créé votre premier document avec les Skills, essayez ces variations :

Créer une feuille de calcul

response = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=4096,
    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"}],
)

Créer un document Word

response = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=4096,
    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"}],
)

Générer un PDF

response = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=4096,
    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"}],
)

Étapes suivantes

Maintenant que vous avez utilisé les Agent Skills pré-construits, vous pouvez :