Les skills

Une skill empaquette une fois pour toutes une procédure — des instructions, du code, des documents de référence — pour la réutiliser d’un appel à l’autre. Plutôt que de répéter les mêmes consignes dans chaque prompt, vous les rangez dans une skill que Claude charge quand la tâche s’y prête.

Ce qu’est une skill

D’après la documentation, les skills sont des ressources sous forme de fichiers qui donnent à Claude une expertise de domaine : des méthodes, du contexte et des bonnes pratiques qui transforment un agent généraliste en spécialiste. À la différence d’un prompt, valable pour une conversation, une skill se charge à la demande.

Concrètement, une skill est un dossier : un fichier SKILL.md avec un nom et une description, des instructions, et au besoin des scripts et des fichiers de référence, organisés comme un guide d’accueil pour un nouveau collègue. Claude travaille dans une machine virtuelle avec un système de fichiers, ce qui permet la divulgation progressive : il ne charge les informations qu’au moment où il en a besoin, au lieu de remplir le contexte d’avance. Au départ, seuls le nom et la description de chaque skill sont lus.

Les skills d’Anthropic et les vôtres

Anthropic fournit des skills prêtes à l’emploi pour les documents courants : PowerPoint, Excel, Word et PDF. Vous pouvez aussi créer les vôtres. Dans les deux cas, une fois la skill disponible dans l’environnement, Claude l’utilise automatiquement quand votre demande le justifie.

Utiliser une skill par l’API

Les skills s’appuient sur l’outil d’exécution de code : vous les déclarez dans container.skills, en ajoutant l’outil code_execution. Voici l’exemple de génération d’une présentation avec la skill pptx d’Anthropic :

const response = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 16000,
  container: {
    skills: [{ type: "anthropic", skill_id: "pptx", version: "latest" }],
  },
  tools: [{ type: "code_execution_20260521", name: "code_execution" }],
  messages: [{ role: "user", content: "Crée une présentation de 3 diapositives sur notre lancement produit." }],
});

Le fichier produit n’est pas dans le texte de la réponse : il est déposé dans l’environnement, et la réponse contient son identifiant, que vous utilisez pour le télécharger avec l’API Files.

Pour vos propres skills, l’API Skills (/v1/skills) permet de les téléverser une fois et de les référencer ensuite par leur identifiant. Cette API, l’API Files et les skills dans container sont sorties de la bêta : la requête passe par client.messages.create, sans en-tête bêta, avec jusqu’à 20 skills par requête.

Bien écrire une skill

Les règles sont les mêmes que dans Claude Code ou dans les applications Claude, puisque toutes suivent le standard ouvert des Agent Skills :

• une skill, une procédure : plusieurs skills ciblées se combinent mieux qu’une seule qui fait tout ;
• une description précise, qui dit ce que fait la skill et quand l’utiliser, car c’est elle qui la déclenche ;
• des exemples d’entrées et de sorties, et des tests après chaque modification.

Une précaution : les données des skills sont conservées selon la politique standard, et cette fonctionnalité n’est pas éligible à la conservation zéro des données (ZDR). Tenez-en compte si votre organisation a des exigences de ce type.

À vous de jouer

Une présentation générée. Lancez l’exemple de la skill pptx, récupérez l’identifiant du fichier produit dans les résultats de l’exécution de code, puis téléchargez-le avec l’API Files. Ouvrez-le et notez ce que vous changeriez dans votre demande pour obtenir mieux.

Sources officielles : Skills (Claude Academy) · Agent Skills overview · Skills guide

Points clés à retenir

• Une skill est un dossier (SKILL.md, instructions, scripts, références) que Claude charge à la demande
• Divulgation progressive : seuls le nom et la description sont lus au départ
• Par l’API : container.skills + l’outil code_execution ; les fichiers produits se téléchargent avec l’API Files
• Skills d’Anthropic pour PowerPoint, Excel, Word et PDF ; vos propres skills via l’API Skills