Aller au contenu
Module
IA

Skill Claude (Agent Skill) : définition pour PM

Une skill Claude (Agent Skill) regroupe dans un répertoire un SKILL.md, c'est-à-dire des instructions rédigées en Markdown, et parfois des scripts, des modèles ou des documents de référence. Son en-tête donne un nom et une description ; Claude lit ces deux champs en permanence et ne charge le reste que lorsqu'une demande correspond à la description. Les skills fonctionnent dans les applications Claude, dans Claude Code et via l'API.

Définition rédigée par Alex Dionisio, Senior Product Manager. Mis à jour le 13 novembre 2026.

Pourquoi c’est important pour un PM

Une skill transforme une façon de travailler en ressource réutilisable : votre trame de PRD, votre grille de relecture d'une spec, votre méthode d'analyse des retours clients. Au lieu de recopier les mêmes consignes à chaque conversation, vous les écrivez une fois, vous les versionnez et vous les partagez avec l'équipe. Pour un PM, c'est aussi un moyen simple de rendre un savoir-faire explicite, donc discutable et améliorable.

Exemple

Une équipe produit crée une skill « compte rendu d'entretien utilisateur ». Le fichier SKILL.md décrit la structure attendue (contexte, problèmes cités, verbatims, hypothèses à vérifier) et un modèle vierge l'accompagne. Quand un PM colle la transcription d'un entretien en demandant une synthèse, Claude reconnaît la situation grâce à la description, charge la skill et produit un compte rendu au format de l'équipe.

Comment une skill est-elle chargée par Claude ?

Le chargement se fait par paliers. Au démarrage, seuls les champs name et description de chaque skill installée sont présentés à Claude, soit une centaine de tokens environ par skill. Quand une demande correspond à une description, il lit le corps du fichier SKILL.md. Les fichiers annexes (références, modèles, scripts) ne sont ouverts que si les instructions y renvoient et que la tâche les réclame ; un script est exécuté, et seul son résultat entre dans le contexte. Ce découpage permet d'installer de nombreuses skills sans encombrer la fenêtre de contexte.

Le nom suit des règles strictes : lettres minuscules, chiffres et tirets, 64 caractères au plus, sans les mots réservés claude ou anthropic. La description, limitée à 1 024 caractères, est le texte principal auquel Claude compare la demande pour décider d'utiliser la skill. Elle mérite donc autant de soin qu'une bonne accroche : le service rendu, puis les mots qu'un utilisateur emploierait pour la demander.

Skill, MCP, CLAUDE.md ou sous-agent : que choisir ?

Un serveur MCP donne à Claude un accès à un système extérieur : un outil de tickets, une base de données, un service de documentation. Une skill lui apprend une façon de faire. Les deux se combinent bien : un serveur MCP ouvre l'accès à votre outil d'analytics, une skill explique comment en tirer le bilan hebdomadaire attendu par la direction.

Le fichier CLAUDE.md, dans Claude Code, est lu à chaque session : il convient aux règles qui valent pour tout le projet. La skill, chargée à la demande, convient aux procédures utiles de temps en temps. Un sous-agent, enfin, est un assistant séparé, doté de sa propre fenêtre de contexte, à qui l'on délègue une tâche. Claude Code permet aussi d'appeler une skill directement par son nom, comme une commande précédée d'une barre oblique.

Comment créer, tester et partager une skill ?

Côté Claude Code, deux emplacements coexistent : ~/.claude/skills/ pour vos skills personnelles, et, pour celles de l'équipe, un répertoire .claude/skills/ placé à la racine du dépôt, dont le contenu est versionné avec le code et partagé via git. Dans les applications Claude, on importe une skill sous forme d'archive ZIP depuis l'espace de personnalisation ; la fonction suppose que l'exécution de code soit activée. Côté API, les skills se gèrent par des points d'accès dédiés. Anthropic a par ailleurs publié le format comme standard ouvert, que d'autres outils peuvent adopter.

Pour tester une skill, soumettez-lui une dizaine de demandes réelles, formulées de manières variées, et notez celles qui la déclenchent à tort ou pas du tout. Côté sécurité, Anthropic recommande de se limiter aux skills de source fiable, créées par vous ou fournies par Anthropic, et d'examiner entièrement les autres avant usage : une skill malveillante peut pousser Claude à appeler des outils ou à exfiltrer des données d'une façon contraire à son objet annoncé.

Points clés

  • Le fichier SKILL.md commence par un en-tête YAML ; name et description y sont exigés par l'API et les applications Claude.
  • La description décide du déclenchement : elle précise à la fois le service rendu et les situations où y recourir.
  • Le chargement est progressif : seule la description occupe le contexte tant que la skill ne sert pas.
  • Une skill peut embarquer des scripts que Claude exécute, ce qui demande la même vigilance qu'un logiciel installé.

Erreurs fréquentes

  • Écrire une description vague, si bien que la skill ne se déclenche jamais ou se déclenche à tort.
  • Installer une skill trouvée en ligne sans lire ses instructions ni ses scripts.
  • Tout mettre dans une seule skill géante au lieu de plusieurs skills ciblées.

Pour aller plus loin dans Module

Les formations et les leçons qui traitent cette notion :

Guides sur ce thème