Chargement
Chargement

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.

Comparaison côte à côte des outils et des Skills : les outils se connectent aux données, entreprennent des actions et exécutent du code — ce que Claude peut faire ; les Skills enseignent une procédure avec seulement des instructions, aucun code ne s'exécute — 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 :

python
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 requests

Pour 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 :

python
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êta skills-2025-10-02 n'est plus nécessaire ; les requêtes qui l'envoient encore continuent de fonctionner sans changement.
  • container.skills est 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.

Sortie terminal du rapport d'état quotidien généré, avec des sections Done et Blockers et un résumé formaté par 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.

Une application de gestion de projet avec une page de rapports quotidiens, où le journal d'activité de chaque projet dispose d'un bouton Générer un rapport en un clic, alimenté par la Skill

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 avec container.skills sur n'importe quel appel messages.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.