Créer une skill Claude, de l’installation aux tests
Claude Skills expliquées aux PM : anatomie du SKILL.md, installation dans claude.ai ou Claude Code, description qui déclenche, tests et sécurité.
Guide rédigé par Alex Dionisio, Senior Product Manager. Mis à jour le 13 novembre 2026.
En bref
Une Claude Skill, c’est un fichier SKILL.md rangé dans son propre dossier : un nom, une description, puis des instructions que Claude charge seulement quand votre demande correspond à la description. Elle transforme une méthode récurrente (synthèse de retours, revue de spec, PRD) en réflexe réutilisable. Elle fonctionne dans claude.ai, Claude Code et l’API, mais chaque surface s’installe séparément. La qualité dépend surtout de la description et des tests.
Qu’est-ce qu’une Claude Skill ?
Une Claude Skill (ou Agent Skill) est un dossier organisé autour d’un fichier SKILL.md, qui porte des métadonnées et des instructions, plus d’éventuels fichiers de référence et scripts. Claude la charge automatiquement quand une demande correspond à sa description, sans que vous ayez à recoller un long prompt.
Anthropic décrit les skills comme des ressources réutilisables, stockées sous forme de fichiers, qui donnent à Claude une expertise de domaine : un workflow, un contexte métier, des règles de qualité. La différence avec une consigne tapée dans la conversation tient en un mot : la skill est chargée à la demande. Vous l’écrivez une fois, Claude s’en sert chaque fois que la tâche s’y prête.
Le mécanisme clé s’appelle le chargement progressif (progressive disclosure dans la documentation officielle). Il se fait en trois niveaux :
- Métadonnées : nom et description de toutes les skills installées sont toujours présents, pour environ 100 tokens par skill selon Anthropic.
- Instructions : les consignes rédigées sous le frontmatter rejoignent la fenêtre de contexte au seul moment du déclenchement.
- Ressources : les fichiers annexes ne sont lus que si les instructions y renvoient ; les scripts sont exécutés et seul leur résultat est lu.
Vous pouvez donc installer de nombreuses skills sans encombrer chaque conversation. La leçon comment Claude décide de charger une skill détaille ce fonctionnement avec des exemples de PM.
Skill, prompt, projet ou MCP : quelle différence ?
Un prompt sert une demande ponctuelle, un projet claude.ai regroupe des conversations autour de documents et d’instructions communs, un serveur MCP connecte Claude à des outils ou données externes, et une skill apporte une méthode réutilisable que Claude charge seulement quand la tâche la demande.
Partez de la question que vous vous posez :
- « Je veux un résultat maintenant » : un prompt bien construit suffit. Si vous le recopiez chaque semaine, c’est le signal qu’il peut devenir une skill.
- « Je veux que Claude connaisse ce dossier » : un projet claude.ai garde des documents et des instructions à portée de toutes les conversations du projet, et seulement de celles-là.
- « Je veux que Claude accède à cet outil » : il faut un serveur MCP (Model Context Protocol), qui donne accès à Jira, Notion, une base de données. La formation consacrée à MCP traite ce sujet.
- « Je veux que Claude applique ma méthode » : c’est une skill. Elle peut d’ailleurs s’appuyer sur des outils MCP, en les citant par leur nom complet.
Dans Claude Code, deux autres options entrent en jeu : le fichier CLAUDE.md, chargé à chaque session, et les hooks, qui exécutent une commande à un moment précis sans passer par le jugement du modèle. Pour choisir entre ces cinq options et défendre ce choix, voyez la leçon choisir entre skill, CLAUDE.md, subagent, MCP et hook.
Où fonctionnent les skills : claude.ai, Claude Code ou API ?
Les skills fonctionnent dans claude.ai (à condition d’y autoriser l’exécution de code), dans Claude Code et via l’API Claude, couplées à l’outil qui exécute du code. Une skill personnalisée ne se synchronise pas entre ces surfaces : il faut l’ajouter séparément à chaque endroit où vous voulez l’utiliser.
Le centre d’aide Claude précise que les skills reposent sur l’environnement d’exécution de code : sans lui, elles ne se chargent pas. La disponibilité et les réglages diffèrent selon l’offre (individuelle, Team, Enterprise), et sur les offres d’équipe un propriétaire d’organisation doit parfois les activer. Vérifiez la page d’aide pour votre compte plutôt que de supposer.
- claude.ai : skills prédéfinies d’Anthropic pour les documents (Word, Excel, PowerPoint, PDF) et skills personnalisées importées en ZIP. L’accès réseau dépend des réglages de l’utilisateur ou de l’administrateur.
- Claude Code : skills personnalisées sous forme de dossiers sur votre disque, sans import. Elles ont le même accès réseau que n’importe quel programme de votre machine.
- API Claude : skills prédéfinies et skills importées via l’API Skills, partagées avec tout l’espace de travail. Elles s’exécutent dans un conteneur sans accès réseau.
Pour un PM : claude.ai pour un usage personnel sans terminal, Claude Code pour une skill versionnée et partagée avec l’équipe.
Comment est construit un fichier SKILL.md ?
Un fichier SKILL.md s’ouvre sur un bloc YAML, le frontmatter, encadré par deux lignes ---, avec au minimum un name et une description, suivi d’instructions en Markdown. Des fichiers annexes (références, exemples, scripts) peuvent être placés dans le même dossier et cités depuis le corps.
La structure minimale ressemble à ceci :
---
name: synthese-retours
description: Synthétise des retours utilisateurs en thèmes classés. À utiliser quand on fournit des verbatims, avis ou tickets à analyser.
---
# Synthèse de retours
## Étapes
1. ...
## Format de sortie
...Les règles des deux champs obligatoires, selon la documentation Anthropic :
name: 64 caractères au maximum, uniquement des minuscules, des chiffres et des tirets ;anthropicetclaudey sont interdits.description: non vide, 1 024 caractères au maximum, sans balises XML. Elle indique l’action de la skill et les situations où s’en servir.
Dans Claude Code, d’autres champs sont reconnus, par exemple disable-model-invocation pour réserver le lancement à la commande /nom-de-la-skill, ou allowed-tools pour pré-autoriser certains outils pendant l’exécution. Ils ne sont pas tous lus par les autres surfaces : la liste complète est sur la page Skills de Claude Code.
Côté corps, Anthropic conseille un corps de moins de 500 lignes ; au-delà, le détail part dans des fichiers annexes cités directement depuis le SKILL.md, sur un seul niveau de profondeur. La leçon anatomie d’un SKILL.md passe chaque partie en revue et indique ce qui reste portable entre outils.
Comment installer une skill Claude ?
Pour installer une skill dans claude.ai, compressez son dossier en ZIP et importez-le dans Personnaliser puis Skills. Dans Claude Code, placez le dossier sous ~/.claude/skills/ pour un usage personnel ou dans .claude/skills/ du dépôt pour toute l’équipe.
Dans claude.ai, la procédure décrite par le centre d’aide est la suivante :
- Activez l’exécution de code et la création de fichiers dans les réglages, au besoin.
- Compressez le dossier de la skill : le ZIP doit contenir le dossier lui-même à sa racine, avec le
SKILL.mddedans. - Ouvrez Personnaliser, puis Skills, cliquez sur « + », créez une skill et choisissez l’import.
- Activez la skill dans la liste, puis ouvrez une nouvelle conversation pour la tester.
Les échecs d’import les plus fréquents cités par Anthropic : un nom de dossier différent du name, un SKILL.md absent, un caractère non autorisé dans l’un des deux champs, un ZIP trop lourd.
Dans Claude Code, aucun import n’est nécessaire. Un dossier ~/.claude/skills/<nom>/SKILL.md est disponible dans tous vos projets ; un dossier .claude/skills/<nom>/SKILL.md versionné dans le dépôt l’est pour tous ceux qui travaillent dessus. La commande /skills liste ce qui est chargé, et /nom-de-la-skill lance une skill directement. Les skills peuvent aussi être distribuées via des plugins.
Pour suivre l’installation pas à pas et vérifier que Claude prend bien le fichier en compte, voyez la leçon écrire le SKILL.md et l’installer. Si Claude Code est nouveau pour vous, le guide Claude Code pour Product Manager pose les bases.
Quelle première skill écrire quand on est PM ?
La bonne première skill de PM part d’une tâche que vous refaites souvent, avec des exigences stables et un résultat que vous savez juger : synthèse de retours, revue de spec, compte rendu de réunion. Commencez par décrire le livrable attendu, puis écrivez le minimum d’instructions pour l’obtenir.
Trois critères aident à trier vos candidats : la tâche se répète toutes les semaines ou plus, vous corrigez toujours les mêmes défauts dans la réponse de Claude, et vous pourriez confier le travail à quelqu’un d’autre à condition de lui donner votre méthode. Exemples de bonnes candidates :
- Classer des verbatims d’entretiens ou des avis en thèmes avec leur fréquence.
- Relire une spec avant de la passer à l’équipe et lister les trous (critères d’acceptation, cas limites, données).
- Transformer des notes brutes de réunion en décisions, actions et responsables.
Méthode simple : faites la tâche avec Claude sans skill, notez ce que vous avez dû préciser ou corriger, demandez à Claude d’en faire un SKILL.md, puis retirez tout ce que Claude sait déjà. Une fois chargée, chaque ligne du corps occupe du contexte.
Le modèle gratuit en bas de page vous donne une structure de départ. La formation Claude Skills va plus loin : cadrage du livrable avant l’écriture, règles vérifiables, choix des outils autorisés, jusqu’à une skill testée et installée.
Comment rédiger une description qui déclenche la skill ?
Une description efficace résume en une ou deux phrases l’action de la skill et les situations où l’utiliser, à la troisième personne, avec les mots que vous employez vraiment dans vos demandes. C’est l’unique texte sur lequel Claude s’appuie pour activer ou non la skill.
Avant le déclenchement, Claude ne dispose, pour une skill, que de son nom et de sa description. Formulée trop vaguement (« aide sur des documents »), elle reste muette ; une description trop large la fait intervenir partout. Les bonnes pratiques d’Anthropic donnent quelques règles :
- Écrire à la troisième personne : « Synthétise des retours… » plutôt que « Je peux vous aider à… ».
- Couvrir le quoi et le quand : l’action produite, puis « À utiliser quand… » avec les déclencheurs.
- Employer les termes concrets de vos demandes : verbatims, NPS, tickets, interviews, plutôt qu’un vocabulaire générique.
- Choisir un nom explicite, en minuscules et tirets, plutôt que
helperououtils.
Testez ensuite le déclenchement dans les deux sens : des demandes qui devraient activer la skill, formulées de plusieurs façons, et des demandes voisines qui ne devraient pas l’activer. Une description se règle comme un critère de recherche, par essais successifs. La leçon écrire une description qui déclenche au bon moment aborde aussi le choix de qui peut lancer la skill.
Comment tester une skill et l’améliorer ?
Pour tester une skill, préparez au moins trois scénarios réalistes, comparez la réponse de Claude avec et sans la skill, puis corrigez les instructions à partir des écarts observés. Une skill qui ne fait pas mieux que Claude seul n’a pas de raison d’exister.
Anthropic recommande de construire les évaluations avant d’écrire beaucoup d’instructions. Le principe est proche d’un test d’acceptation produit :
- Lancez Claude sans la skill sur des tâches représentatives et notez ce qui manque.
- Rédigez trois scénarios ou plus, chacun avec la demande, les fichiers fournis et les comportements attendus.
- Mesurez le résultat de référence sans la skill.
- Écrivez juste assez d’instructions pour combler les écarts.
- Relancez les scénarios dans une conversation neuve, comparez, ajustez.
Anthropic suggère de rédiger la skill avec une instance de Claude et de la tester dans une autre conversation, vierge, sur de vraies tâches. Un fichier annexe jamais lu est soit inutile, soit mal signalé. Si vous utilisez plusieurs modèles, testez sur chacun.
Dans Claude Code, la documentation propose de comparer des sessions avec et sans la skill et de vérifier le déclenchement automatique puis manuel. La leçon tester une skill avant de s’y fier détaille la méthode d’évaluation.
Peut-on installer une skill trouvée en ligne sans risque ?
Non, pas sans l’avoir lue. Anthropic conseille de s’en tenir aux skills venues de sources fiables, car une skill malveillante peut amener Claude à lancer des outils ou du code contre votre intérêt, jusqu’à exfiltrer des données. Auditez chaque fichier avant de l’activer.
Une skill est du texte et parfois du code que Claude suit avec les droits dont il dispose à ce moment-là. Installer une skill revient donc à installer un logiciel. La documentation Anthropic et le centre d’aide nomment deux risques principaux : l’injection de prompt et la fuite de données.
Avant d’activer une skill tierce, y compris partagée par un collègue :
- Lisez tous les fichiers du dossier :
SKILL.md, références, scripts, images. - Cherchez les actions étrangères au but annoncé : appels réseau, lecture de fichiers sensibles, envoi de contenu vers une URL.
- Méfiez-vous des skills qui vont chercher des instructions sur une URL externe : leur contenu peut changer après votre audit.
- Dans Claude Code, limitez les outils autorisés et gardez une validation humaine pour les actions irréversibles.
Sur les offres Enterprise, Anthropic propose une analyse automatique des skills importées dans claude.ai, mais elle ne remplace pas votre lecture. La leçon choisir, auditer et partager des skills propose une grille d’audit et les options de diffusion en équipe.
Modèle gratuit : SKILL.md
Un SKILL.md minimal et commenté pour une première skill de synthèse de retours. Remplacez les passages entre crochets, supprimez les commentaires, placez le fichier dans un dossier du même nom que le champ name, puis installez-le.
---
# name : minuscules, chiffres et tirets, 64 caractères max.
# Interdit : les mots "anthropic" et "claude". Même nom que le dossier.
name: synthese-retours-utilisateurs
# description : l'action de la skill + les situations où s'en servir, à la 3e personne.
# C'est l'unique texte sur lequel Claude s'appuie pour activer la skill.
description: Synthétise des retours utilisateurs (verbatims, avis, tickets, réponses NPS) en thèmes classés par fréquence, avec citations. À utiliser quand on fournit des retours bruts à analyser ou qu'on demande une synthèse de feedback.
---
# Synthèse de retours utilisateurs
## Objectif
Produire une synthèse que [lecteur : ex. l'équipe produit] peut lire
en deux minutes pour décider des prochains sujets de discovery.
## Entrées attendues
- Des retours bruts : texte collé, fichier CSV ou export d'outil.
- Si la source ou la période manque, la demander avant de commencer.
## Étapes
1. Lire tous les retours avant de regrouper quoi que ce soit.
2. Regrouper en 3 à 7 thèmes, nommés avec les mots des utilisateurs.
3. Compter les retours par thème et classer du plus au moins fréquent.
4. Pour chaque thème, citer 1 ou 2 verbatims exacts, sans les reformuler.
5. Signaler à part les retours isolés mais graves (sécurité, perte de données).
## Règles
- Ne jamais inventer de verbatim ni de chiffre absent des données.
- Distinguer ce que disent les utilisateurs de vos hypothèses.
- [Ajoutez ici la règle que vous corrigez le plus souvent à la main.]
## Format de sortie
| Thème | Nb de retours | Verbatim représentatif |
|-------|---------------|------------------------|
Puis : « Points d'attention » (3 lignes max) et « Questions ouvertes ».
## Vérification avant de répondre
- Le total des retours par thème correspond au nombre de retours fournis.
- Chaque verbatim cité se retrouve à l'identique dans les données.
## Fichiers annexes (optionnel)
Pour les termes métier, lire reference.md (à créer dans le même dossier
si vous avez un glossaire produit ou une grille de priorisation).
Passer à la pratique
La formation « Créer des Claude Skills fiables pour votre travail produit » vous guide pas à pas, sur votre propre produit, jusqu’au livrable.
Voir la formationQuestions fréquentes
Les Claude Skills sont-elles gratuites ?
Les skills ne sont pas vendues à part : elles font partie de claude.ai, de Claude Code et de l’API, mais elles exigent l’exécution de code et leur disponibilité varie selon l’offre. Le centre d’aide Claude indique ce qui s’applique à votre compte.
Faut-il savoir coder pour créer une skill Claude ?
Non. Une skill peut se limiter à un SKILL.md écrit en Markdown, avec des instructions en langage courant. Les scripts sont optionnels et servent aux opérations qui doivent donner exactement le même résultat à chaque fois.
Pourquoi ma skill ne se déclenche-t-elle pas ?
Dans la plupart des cas, la description est trop vague ou ne reprend pas le vocabulaire de vos demandes. Vérifiez aussi que la skill est activée, que l’exécution de code l’est, et que le dossier porte le même nom que le champ name. Dans Claude Code, la commande /skills liste les skills chargées.
Une skill créée dans claude.ai est-elle disponible dans l’API ?
Non. Selon Anthropic, les skills personnalisées ne se synchronisent pas entre claude.ai, l’API et Claude Code : chaque surface s’installe séparément. Les skills activées sur un compte claude.ai peuvent toutefois être reprises dans Claude Code quand vous êtes connecté avec ce compte.
Quelle est la longueur idéale d’un SKILL.md ?
Anthropic conseille un corps de SKILL.md de moins de 500 lignes, avec le détail réparti dans des fichiers annexes cités depuis le corps. Plus court reste préférable : gardez uniquement les informations que Claude ignore.
Comment partager une skill avec mon équipe ?
Dans Claude Code, versionnez le dossier dans .claude/skills/ du dépôt. Dans claude.ai, les offres Team et Enterprise permettent d’ouvrir une skill à des collègues depuis la liste des skills, en lecture seule pour les destinataires.