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 Anthropic
Python 3.7+ ou curl installé
Familiarité de base avec les demandes d'API

Que sont les Agent Skills ?

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

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

Vous voulez créer des Skills personnalisés ? Consultez le Agent Skills Cookbook pour des exemples de création de vos propres Skills avec une expertise spécifique au domaine.

Étape 1 : Lister les Skills disponibles

Commençons par voir quels Skills sont disponibles. Nous utiliserons l'API Skills pour lister tous les Skills gérés par 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, nous utiliserons le Skill PowerPoint pour créer une présentation sur les énergies renouvelables. Nous spécifions les Skills en utilisant le paramètre container dans l'API Messages :

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

Lorsque 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 :

Pour plus de détails sur le travail avec les fichiers générés, consultez la documentation de l'outil d'exécution de code.

Essayez d'autres exemples

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

Créer une feuille de calcul

Créer un document Word

Générer un PDF

Prochaines étapes

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

Guide API

Utiliser les Skills avec l'API Claude

import anthropic

client = anthropic.Anthropic()

# List Anthropic-managed Skills
skills = client.beta.skills.list(
    source="anthropic",
    betas=["skills-2025-10-02"]
)

for skill in skills.data:
    print(f"{skill.id}: {skill.display_title}")

import anthropic

client = anthropic.Anthropic()

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

# 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")

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

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

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