MessagesCompétences

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 à activer les Skills, à effectuer une requête simple et à accéder au fichier généré.

Prérequis

Clé API Claude
Python 3.7+ ou curl installé
Connaissance de base des requêtes API

Aperçu des Agent Skills

Les Agent Skills préconfigurés étendent les capacités de Claude avec une expertise spécialisée pour des tâches telles que la création de documents, l'analyse de données et le traitement de fichiers. Anthropic fournit les Agent Skills préconfigurés 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 souhaitez 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 à un domaine.

Étape 1 : Lister les Skills disponibles

Commencez par vérifier quels Skills sont disponibles. Utilisez l'API Skills pour lister tous les Skills gérés par Anthropic :

# Lister 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 renvoie 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. Il s'agit du premier niveau de « progressive disclosure » (divulgation progressive), où Claude découvre les Skills sans encore charger leurs instructions complètes.

Étape 2 : Créer une présentation

Utilisez maintenant le Skill PowerPoint pour créer une présentation sur les énergies renouvelables. Spécifiez les Skills à l'aide du paramètre container dans l'API Messages :

# Créer un message avec le Skill PowerPoint
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)}")

Décomposons le rôle de chaque élément :

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 bêta : code-execution-2025-08-25 et skills-2025-10-02

Les exemples présentés ici utilisent la version de l'outil code_execution_20250825 avec son en-tête bêta correspondant code-execution-2025-08-25. Les Skills fonctionnent également avec les révisions plus récentes de l'outil d'exécution de code (code_execution_20260120 et ultérieures) ; toute version de l'outil d'exécution de code satisfait l'exigence des Skills. Quelle que soit la version que vous utilisez, veillez à ce que le type de l'outil et l'en-tête bêta restent cohérents avec la page de l'outil d'exécution de code, et incluez toujours skills-2025-10-02.

Lorsque vous effectuez cette requête, Claude associe automatiquement 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. Claude exécute ensuite 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 identifiant de fichier. Extrayez l'identifiant de fichier et téléchargez-le à l'aide de l'API Files :

# Extraire l'ID du fichier du résultat de l'outil d'exécution de code. Le Skill peut exécuter
# son travail via l'outil d'exécution de code Python ou bash, donc vérifiez
# les deux types de résultats.
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:
    # Télécharger le fichier et l'enregistrer
    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}")

Pour des détails complets sur l'utilisation des 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 variantes :

Créer une feuille de calcul

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

Créer un document Word

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

Générer un PDF

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

Prochaines étapes

Maintenant que vous avez utilisé les Agent Skills préconfigurés, vous pouvez :

Guide de l'API

Utiliser les Skills avec l'API Claude

Créer des Skills personnalisés

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

Guide de rédaction

Découvrir les bonnes pratiques pour rédiger des Skills efficaces

Utiliser les Skills dans Claude Code

En savoir plus sur les Skills dans Claude Code

Agent Skills Cookbook

Explorer des exemples de Skills et des modèles d'implémentation

Was this page helpful?

MessagesCompétences

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 Claude
Python 3.7+ ou curl installé
Connaissance de base des requêtes API

Aperçu des 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 souhaitez 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 à un domaine.

Étape 1 : Lister les Skills disponibles

Commencez par vérifier quels Skills sont disponibles. Utilisez l'API Skills pour lister tous les Skills gérés par Anthropic :

# Lister les Skills gérés par Anthropic
ant beta:skills list --source anthropic

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

Étape 2 : Créer une présentation

Utilisez maintenant le Skill PowerPoint pour créer une présentation sur les énergies renouvelables. Spécifiez les Skills à l'aide du paramètre container dans l'API Messages :

# Créer un message avec le Skill PowerPoint
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)}")

Décomposons le rôle de chaque élément :

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 bêta : code-execution-2025-08-25 et skills-2025-10-02

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

# Extraire l'ID du fichier du résultat de l'outil d'exécution de code. Le Skill peut exécuter
# son travail via l'outil d'exécution de code Python ou bash, donc vérifiez
# les deux types de résultats.
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:
    # Télécharger le fichier et l'enregistrer
    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}")

Pour des détails complets sur l'utilisation des 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 variantes :

Créer une feuille de calcul

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

Créer un document Word

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

Générer un PDF

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

Prochaines étapes

Maintenant que vous avez utilisé les Agent Skills préconfigurés, vous pouvez :

Guide de l'API

Utiliser les Skills avec l'API Claude

Créer des Skills personnalisés

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

Guide de rédaction

Découvrir les bonnes pratiques pour rédiger des Skills efficaces

Utiliser les Skills dans Claude Code

En savoir plus sur les Skills dans Claude Code

Agent Skills Cookbook

Explorer des exemples de Skills et des modèles d'implémentation

Was this page helpful?

Prérequis

Aperçu des Agent Skills

Étape 1 : Lister les Skills disponibles

Étape 2 : Créer une présentation

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

Essayez d'autres exemples

Créer une feuille de calcul

Créer un document Word

Générer un PDF

Prochaines étapes

Prérequis

Aperçu des Agent Skills

Étape 1 : Lister les Skills disponibles

Étape 2 : Créer une présentation

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

Essayez d'autres exemples

Créer une feuille de calcul

Créer un document Word

Générer un PDF

Prochaines étapes

Prérequis

Aperçu des Agent Skills

Étape 1 : Lister les Skills disponibles

Étape 2 : Créer une présentation

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

Essayez d'autres exemples

Créer une feuille de calcul

Créer un document Word

Générer un PDF

Prochaines étapes

Prérequis

Aperçu des Agent Skills

Étape 1 : Lister les Skills disponibles

Étape 2 : Créer une présentation

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

Essayez d'autres exemples

Créer une feuille de calcul

Créer un document Word

Générer un PDF

Prochaines étapes