Skills
Les Skills sont des dossiers d'instructions, de scripts et de ressources
que Claude charge dynamiquement pour améliorer ses performances sur des
tâches spécialisées. Au cœur de chaque Skill se trouve un fichier
SKILL.md — un ensemble d'instructions empaqueté que vous téléchargez une
fois puis que vous joignez à n'importe quel appel messages.create. Vous
enseignez à Claude comment vous faites quelque chose : votre format de
rapport d'état, votre liste de vérification de révision, vos notes de
version. Claude lit la Skill, suit la procédure, et produit un résultat
dans votre format.
Skills et outils
Il est important de bien comprendre la différence, car les deux résolvent des problèmes différents :
- Les outils connectent Claude à des données et des actions. « Recherche cette section de code », « envoie cet e-mail » — Claude appelle l'outil, et autre chose s'exécute.
- Les Skills enseignent une procédure à Claude. « Génère le rapport d'état quotidien en suivant ce modèle » — c'est un guide que Claude lit et suit, ce qui implique parfois d'exécuter lui-même des scripts fournis.
Un moyen simple de s'en souvenir : les outils concernent ce que Claude peut faire, tandis que les Skills concernent comment vous voulez que ce soit fait.

Autre chose à savoir : les Skills ne se chargent pas entièrement dans le contexte au démarrage. Seuls le nom et la description se chargent au départ. Lorsque votre agent décide qu'une Skill est pertinente, il charge alors la Skill complète dans le contexte. Cela permet de garder votre contexte léger même lorsque de nombreuses Skills sont disponibles.
Télécharger une Skill
Les Skills sont téléchargées une fois dans votre espace de travail, puis référencées par ID. Vous pouvez les télécharger directement sur Claude Platform, ou le faire de manière programmatique :
import anthropic
from anthropic.lib import files_from_dir
client = anthropic.Anthropic()
skill = client.skills.create(
display_name="Status Report Generator",
files=files_from_dir("status-report-skill"), # folder containing SKILL.md
)
print(skill.id) # reference this ID in future requestsPour cet exemple, je souhaite un générateur de rapport d'état. Toutes les règles définissant ce qui fait un bon rapport d'état — sections, ton, manière de résumer, manière de gérer les blocages — figurent dans une Skill empaquetée à l'avance. Le journal d'activité lui-même est simplement une chaîne de caractères transmise au moment de la requête.
Joindre une Skill à une requête
Les Skills se joignent à une requête via la configuration du conteneur — un tableau skills à l'intérieur du conteneur, où chaque entrée nomme un skill_id et une version. Voici l'appel complet pour le générateur de rapport d'état :
response = client.messages.create(
model="claude-opus-5",
max_tokens=4096,
container={
"skills": [
{
"type": "custom",
"skill_id": skill.id,
"version": "latest",
}
]
},
tools=[
{
"type": "code_execution_20250825",
"name": "code_execution",
}
],
messages=[
{
"role": "user",
"content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
}
],
)Quelques points à souligner :
- Nous appelons la méthode standard
client.messages.create, sans en-tête bêta. Les Skills sont disponibles en version générale sur Claude API, donc l'en-tête bêtaskills-2025-10-02n'est plus nécessaire ; les requêtes qui l'envoient encore continuent de fonctionner sans changement. container.skillsest l'endroit où la Skill se joint. C'est une liste, vous pouvez donc superposer plusieurs Skills sur un seul appel.- L'exécution de code est également activée ici. C'est obligatoire : sur l'API, les Skills s'exécutent à l'intérieur du conteneur de l'outil d'exécution de code, ce qui permet aux procédures de Skill d'effectuer un travail réel — comme exécuter des scripts dans un terminal.
Exécution
Le résultat est un rapport d'état formaté exactement de la façon dont la Skill indique de le formater. Les sections, le ton, la gestion des blocages — tout provient du fichier SKILL.md que vous avez téléchargé. La requête de l'utilisateur tient en une ligne ; la procédure réside dans la Skill.

Dans une application de production, c'est ainsi qu'une équipe uniformise les résultats pour l'ensemble d'une fonctionnalité. Avec ce point d'accès de rapport d'état quotidien, chaque chef de projet obtient la même structure, le même ton, les mêmes sections, dans le même ordre — sans que personne n'ait besoin de copier-coller un modèle dans une requête.

Récapitulatif
- Les Skills empaquettent vos procédures. Un fichier
SKILL.md(accompagné de tout script et ressource) enseigne à Claude comment vous voulez que quelque chose soit fait. - Outils vs. Skills : les outils concernent ce que Claude peut faire ; les Skills concernent comment vous voulez que ce soit fait.
- Les Skills se chargent progressivement. Seuls le nom et la description se chargent au démarrage ; la Skill complète se charge dans le contexte lorsque l'agent décide de l'utiliser.
- Téléchargez une fois avec
client.skills.create, puis joignez-la aveccontainer.skillssur n'importe quel appelmessages.create— une liste, vous pouvez donc superposer plusieurs Skills. - Associez-la à l'exécution de code lorsque la procédure de la Skill doit effectuer un travail réel.
- Tournez-vous vers une Skill lorsque le comment compte autant que le quoi.