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 l'envoi de requêtes API

Présentation des Agent Skills

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

Étape 1 : Lister les Skills disponibles

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

# Lister les Skills gérées par Anthropic
skills = client.skills.list(source="anthropic")

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

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 déterminer 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 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 la Skill PowerPoint
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    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 éléments suivants :

• model : un modèle qui prend en charge l'outil d'exécution de code
• 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)

Lorsque vous effectuez cette requête, Claude associe automatiquement votre tâche au Skill pertinent. Comme 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 sous forme de fichier. La response de l'étape 2 inclut une référence de fichier avec un identifiant de fichier. Extrayez l'identifiant 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 de la Skill via
# son sous-outil Bash, et les fichiers générés apparaissent comme éléments bash_code_execution_output
# à l'intérieur du 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.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Essayer d'autres exemples

Essayez ces variantes :

Créer une feuille de calcul

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

Étapes suivantes