Compétences vs. outils

Les compétences 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 compétence se trouve un fichier SKILL. md — un ensemble d'instructions packagé que vous téléchargez une fois, puis que vous attachez à n'importe quel appel messages. create. Vous enseignez à Claude comment vous faites quelque chose : votre format de rapport de statut, votre liste de contrôle d'examen, vos notes de version. Claude lit la compétence, suit la procédure et produit un résultat à votre image.

Il est utile de clarifier la différence, car les deux résolvent des problèmes différents :

Les outils connectent Claude aux données et aux actions. « Recherche cette section de code », « envoie cet e-mail » — Claude appelle l'outil, et quelque chose d'autre s'exécute.
Les compétences enseignent à Claude une procédure. « Génère le rapport de statut quotidien en suivant ce modèle » — c'est un playbook que Claude lit et suit, ce qui signifie parfois exécuter lui-même des scripts packagés.

Un moyen simple de s'en souvenir : les outils concernent ce que Claude peut faire, tandis que les compétences concernent comment vous voulez que ce soit fait.

Comparaison côte à côte des outils et des compétences : les outils se connectent aux données, effectuent des actions et exécutent du code — ce que Claude peut faire ; les compétences enseignent une procédure avec juste des instructions, aucun code ne s'exécute — comment vous voulez que ce soit fait

Une autre chose à savoir : les compétences ne se chargent pas complètement dans le contexte au démarrage. Seul le nom et la description se chargent d'abord. Quand votre agent décide qu'une compétence est pertinente, il charge alors la compétence complète dans le contexte. Cela garde votre contexte léger même quand de nombreuses compétences sont disponibles.

Télécharger une compétence

Les compétences sont téléchargées une fois dans votre espace de travail, puis référencées par ID. Vous pouvez télécharger directement sur la plateforme Claude, ou le faire par programmation :

skill = client. beta. skills. create( display_title="Status Report Generator", files=files_from_dir("status-report-skill"), # folder containing SKILL. md )

print(skill. id) # reference this ID in future requests

Pour cet exemple, je veux un générateur de rapport de statut. Toutes les règles pour ce qui fait un bon rapport de statut — sections, ton, comment résumer, comment gérer les blocages — vivent dans une compétence packagée à l'avance. Le journal d'activité lui-même n'est qu'une chaîne passée au moment de la requête.

Attacher une compétence à une requête

Les compétences s'attachent à 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 version. Voici l'appel complet pour le générateur de rapport de statut :

response = client. beta. messages. create( model="claude-sonnet-4-5", max_tokens=4096, betas=["skills-2025-10-02", "code-execution-2025-08-25"], 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 à noter :

Nous appelons client. beta. messages. create, pas celui standard, et passons la fonctionnalité des compétences via l'en-tête beta. À ce moment de la vidéo, les compétences sont toujours une fonctionnalité bêta.
container. skills est l'endroit où la compétence s'attache. C'est une liste, donc vous pouvez superposer plusieurs compétences sur un appel.
L'exécution de code est également activée ici. Les compétences s'associent bien à l'exécution de code, car les procédures de compétence peuvent faire du vrai travail — comme exécuter des scripts dans un terminal.

L'exécuter

Le résultat est un rapport de statut formaté exactement comme la compétence le dit. Sections, ton, gestion des blocages — tout cela provient du fichier SKILL. md que vous avez téléchargé. L'invite utilisateur est une ligne ; la procédure vit dans la compétence.

Sortie du terminal du rapport de statut quotidien généré, avec les sections Done et Blockers et un résumé formaté par la compétence

Dans une application de production, c'est ainsi qu'une équipe standardise la sortie sur une fonctionnalité entière. Avec ce point de terminaison de rapport de statut quotidien, chaque PM obtient la même structure, le même ton, les mêmes sections, dans le même ordre — sans que personne ne copie-colle un modèle dans une invite.

Une application de gestion de projet avec une page Rapports quotidiens, où le journal d'activité de chaque projet a un bouton Générer un rapport en un clic soutenu par la compétence

Résumé

**Les compétences packagent vos procédures. ** Un fichier SKILL. md (plus tous les scripts et ressources) enseigne à Claude comment vous voulez que quelque chose soit fait.
**Compétences vs. outils :** les outils concernent ce que Claude peut faire ; les compétences concernent comment vous voulez que ce soit fait.
**Les compétences se chargent progressivement. ** Seul le nom et la description se chargent au démarrage ; la compétence complète se charge dans le contexte quand l'agent décide de l'utiliser.
Téléchargez une fois avec client. beta. skills. create, puis attachez avec container. skills sur n'importe quel appel messages. create — une liste, donc vous pouvez superposer plusieurs compétences.
Associez à l'exécution de code quand la procédure de la compétence doit faire du vrai travail.
Recourez à une compétence quand le comment est aussi important que le quoi.