Compétences d'agent

Démarrer avec les Agent Skills dans l'API

Apprenez à utiliser les Agent Skills pour créer des documents avec l'API Claude en moins de 10 minutes.

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 :

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

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 :

import anthropic

client = anthropic.Anthropic()

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

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

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

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

Prochaines étapes

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

Guide API

Utiliser les Skills avec l'API Claude

Créer des Skills personnalisés

Télécharger vos propres Skills pour des tâches spécialisées

Guide de rédaction

Apprenez les meilleures pratiques pour rédiger des Skills efficaces

Utiliser les Skills dans Claude Code

En savoir plus sur les Skills dans Claude Code

Utiliser les Skills dans l'Agent SDK

Utiliser les Skills par programmation en TypeScript et Python

Agent Skills Cookbook

Explorez les Skills d'exemple et les modèles d'implémentation

Was this page helpful?

Compétences d'agent

Démarrer avec les Agent Skills dans l'API

Apprenez à utiliser les Agent Skills pour créer des documents avec l'API Claude en moins de 10 minutes.

Prérequis

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

Que sont les Agent Skills ?

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 :

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

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

Étape 2 : Créer une présentation

import anthropic

client = anthropic.Anthropic()

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-opus-4-6",
    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 (obligatoire pour les Skills)
En-têtes Beta : code-execution-2025-08-25 et skills-2025-10-02

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

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

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

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

Prochaines étapes

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

Guide API

Utiliser les Skills avec l'API Claude

Créer des Skills personnalisés

Télécharger vos propres Skills pour des tâches spécialisées

Guide de rédaction

Apprenez les meilleures pratiques pour rédiger des Skills efficaces

Utiliser les Skills dans Claude Code

En savoir plus sur les Skills dans Claude Code

Utiliser les Skills dans l'Agent SDK

Utiliser les Skills par programmation en TypeScript et Python

Agent Skills Cookbook

Explorez les Skills d'exemple et les modèles d'implémentation

Was this page helpful?