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



Prérequis

• Une clé API Claude ou une CLI ant connectée
• Un SDK client pour votre langage, ou curl et jq
• Une connaissance de base de la réalisation de requêtes API



Aperçu des Agent Skills

Les Agent Skills préconstruites é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éconstruites suivantes 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



Étape 1 : Lister les Skills disponibles

Tout d'abord, vérifiez quelles Skills sont disponibles. Utilisez l'API Skills pour lister toutes les Skills gérées par Anthropic. Chaque onglet de langage est un extrait d'un script continu, avec les imports et la configuration du client en haut :

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

Vous voyez les Skills suivantes : 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 déterminer quelles Skills sont disponibles. C'est le premier niveau de la divulgation progressive (progressive disclosure), où Claude découvre les Skills sans encore charger leurs instructions complètes.



Étape 2 : Créer une présentation

Utilisez la 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-5",
    max_tokens=16000,
    betas=["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_20260521", "name": "code_execution"}],
)

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

La requête comprend les parties suivantes :

• model : Un modèle qui prend en charge l'outil d'exécution de code
• container.skills : Spécifie quelles Skills Claude peut utiliser
• type: "anthropic" : Indique qu'il s'agit d'une Skill gérée par Anthropic
• skill_id: "pptx" : L'identifiant de la Skill PowerPoint
• version: "latest" : La version de la Skill définie sur la plus récemment publiée
• tools : Active l'exécution de code (requis pour les Skills)
• En-tête bêta : skills-2025-10-02

Lorsque vous effectuez cette requête, Claude fait automatiquement correspondre votre tâche à la Skill pertinente. Comme vous avez demandé une présentation, Claude détermine que la Skill PowerPoint est pertinente et charge ses instructions complètes : le deuxième niveau de divulgation progressive. Ensuite, Claude exécute le code de la 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 response de l'étape 2 inclut une référence de fichier avec un ID de fichier. Extrayez l'ID de fichier et téléchargez le fichier avec l'API Files. L'exemple l'enregistre dans le répertoire temporaire de votre système :

# Extraire l'ID du fichier. L'outil d'exécution de code exécute le code du Skill via
# son sous-outil Bash, et les fichiers générés apparaissent comme des éléments bash_code_execution_output
# dans le bloc bash_code_execution_tool_result.
file_id = None
for block in response.content:
    if 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}")



Essayez d'autres exemples

Essayez ces variantes :



Créer une feuille de calcul

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["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_20260521", "name": "code_execution"}],
)



Créer un document Word

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["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_20260521", "name": "code_execution"}],
)



Générer un PDF

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["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_20260521", "name": "code_execution"}],
)



Prochaines étapes