Pour créer un skill Claude, vous écrivez un dossier contenant un seul fichier : un SKILL.md qui commence par un nom et une description, suivis d’instructions en langage clair. Compressez le dossier, téléversez-le dans Claude (ou déposez-le dans ~/.claude/skills/ pour Claude Code), et Claude le chargera chaque fois qu’une demande correspond à la description. Aucun code, aucun SDK, aucune étape de compilation.
Sur cette page
- Ce qu’il vous faut avant de commencer
- Étape 1 : Choisir une tâche et définir ce qui signifie « terminé »
- Étape 2 : Créer le dossier et le fichier SKILL.md
- Étape 3 : Rédigez le frontmatter (la partie qui détermine quand la compétence se déclenche)
- Étape 4 : Rédigez les instructions comme une méthode, pas comme une ambiance
- Étape 5 : Ajoutez un exemple de sortie finalisée
- Étape 6 : Empaquetez-le et installez-le
- Étape 7 : Testez-le sérieusement
- Modèle gratuit de compétence Claude (à copier et à adapter)
- Cinq erreurs qui rendent une compétence inutile
- Laissez Claude rédiger le premier brouillon pour vous
- Le créer vous-même ou commencer avec un Skill prêt à l’emploi ?
C’est tout le mécanisme. Ce qui distingue un skill qui se déclenche à chaque fois et produit un travail que vous pouvez utiliser d’un skill qui ne se déclenche jamais repose sur environ six décisions, que ce guide présente dans l’ordre. À la fin, vous trouverez un modèle gratuit à copier ainsi qu’une liste de contrôle pour tester votre skill avant de vous y fier.
Si vous découvrez cette notion, commencez par Que sont les skills Claude ?, puis revenez ici. Cette page suppose que vous savez ce qu’est un skill et que vous souhaitez en créer un.
Ce qu’il vous faut avant de commencer
- Un compte Claude avec l’exécution de code activée. Les skills fonctionnent avec les forfaits Free, Pro, Max, Team et Enterprise, mais le paramètre d’exécution de code et de création de fichiers doit être activé. Avec les forfaits Team et Enterprise, un administrateur devra peut-être d’abord activer les skills pour l’organisation.
- Un éditeur de texte. N’importe quel outil qui enregistre du texte brut : VS Code, TextEdit en mode texte brut, Notepad.
- Une tâche répétable. Pas « le marketing ». Quelque chose comme « transformer la transcription d’un appel commercial en note CRM dans notre format » ou « examiner un contrat pour détecter nos cinq signaux d’alerte habituels ». Plus la tâche est précise, meilleur sera le skill.
- Deux ou trois exemples concrets de résultats réussis. D’anciens rapports, e-mails ou briefs que vous seriez heureux d’envoyer. Ce sont les meilleures matières premières pour un skill.
Étape 1 : Choisir une tâche et définir ce qui signifie « terminé »
La plupart des skills qui échouent échouent ici, avant même qu’une ligne soit écrite. Un skill qui tente de couvrir « tout ce que fait un responsable marketing » finit par avoir une description vague, se déclenche au mauvais moment et fournit des réponses génériques lorsqu’il se déclenche.
Écrivez deux phrases avant toute autre chose :
- Le déclencheur : « Utilisez-le lorsqu’une personne demande X ou transmet Y. »
- Le livrable : « Le résultat est un Z avec ces sections, dans cette longueur et sur ce ton. »
Exemple : « Utilisez-le lorsqu’une personne colle la transcription d’un appel client et demande des notes. Le résultat est une note CRM comprenant les sections Résumé, Points sensibles, Budget, Prochaine étape et Risque, de moins de 200 mots, rédigée pour un responsable commercial qui n’a pas participé à l’appel. » Si vous ne pouvez pas rédiger ces deux phrases, divisez la tâche en deux skills.
Étape 2 : Créer le dossier et le fichier SKILL.md
Un skill est un dossier dont le nom correspond au nom du skill. À l’intérieur, le seul fichier requis est SKILL.md (le nom du fichier est sensible à la casse). Les éléments facultatifs vont à côté :
| Chemin | Obligatoire ? | À quoi cela sert |
|---|---|---|
call-notes/SKILL.md |
Oui | Le frontmatter et les instructions que Claude suit |
call-notes/resources/example-output.md |
Recommandé | Un exemple finalisé du livrable |
call-notes/resources/style-guide.md |
Facultatif | Des documents de référence plus longs que Claude ne consulte qu’en cas de besoin |
call-notes/scripts/ |
Facultatif | Des scripts Python ou shell pour les étapes qui doivent être exactes, comme l’analyse d’un fichier CSV |
Conservez le nom du dossier en minuscules avec des traits d’union, comme call-notes ou quarterly-report. La même chaîne de caractères figure dans nom champ à l’étape suivante.
Étape 3 : Rédigez le frontmatter (la partie qui détermine quand la compétence se déclenche)
Le fichier commence par un court bloc YAML entre deux lignes composées de trois traits d’union. Deux champs sont obligatoires :
-
name- lettres minuscules, chiffres et traits d’union, 64 caractères maximum. Il devient l’identifiant et, dans Claude Code, la commande slash (/call-notes). -
description- 1 024 caractères maximum. C’est la seule partie que Claude lit pour chaque compétence installée au début d’une session. Elle détermine si votre compétence est chargée.
Rédigez la description comme si vous donniez des instructions à un collègue qui doit décider en une seconde si une demande relève de sa compétence. Commencez par ce que la compétence produit, puis énumérez les situations et formulations qui doivent la déclencher. Comparez :
- Faible : « Aide à rédiger des notes commerciales. »
- Efficace : « Transforme la transcription d’un appel commercial ou de découverte en une note CRM structurée (Résumé, Points de douleur, Budget, Prochaine étape, Risque) de moins de 200 mots. À utiliser lorsque l’utilisateur colle une transcription d’appel, le texte d’un enregistrement de réunion ou des notes d’appel brutes et demande des notes, un récapitulatif, une entrée CRM ou un résumé de suivi. »
La version efficace nomme l’entrée, la sortie et les mots que les utilisateurs saisissent réellement. C’est ce qui la fait se déclencher de manière fiable tout en restant silencieuse le reste du temps.
Étape 4 : Rédigez les instructions comme une méthode, pas comme une ambiance
Tout ce qui suit le frontmatter est du Markdown que Claude suit une fois la compétence chargée. L’erreur courante consiste à rédiger une longue persona (« Vous êtes un expert commercial de renommée mondiale avec 20 ans d’expérience... ») sans aucune procédure. Claude n’a pas besoin d’un passé. Il a besoin d’étapes, de règles et d’un format cible. Une structure qui fonctionne pour la plupart des compétences métier :
- Entrées - ce que l’utilisateur fournira et ce qu’il faut demander si cela manque (deux questions maximum, puis poursuivre en indiquant les hypothèses retenues).
- Flux de travail - les étapes numérotées dans l’ordre où un professionnel consciencieux les suivrait.
- Format de sortie - les sections, titres, longueur et ton exacts.
- Règles - les éléments qui doivent toujours se produire ou ne jamais se produire (« n’inventez jamais un montant budgétaire ; écrivez « non abordé » »).
- Contrôle qualité - une courte liste que Claude parcourt avant de répondre.
Visez un contenu qui tient sur un ou deux écrans. Si le fichier dépasse environ 500 lignes, déplacez les documents de référence (guides de style longs, listes de prix, textes de politique) dans des fichiers sous resources/ et indiquez à Claude dans SKILL.md quand les ouvrir. Claude ne charge ces fichiers supplémentaires que lorsque la tâche le nécessite, ce qui permet de garder le contexte léger. Pour en savoir plus sur la structure du fichier, consultez Qu'est-ce qu'un fichier SKILL.md ?
Étape 5 : Ajoutez un exemple de sortie finalisée
Un exemple enseigne le format plus rapidement que toute description, quelle que soit sa longueur. Placez un livrable réaliste et finalisé dans resources/example-output.md et faites-y référence depuis le workflow (« respectez la structure et la longueur de resources/example-output.md »). Utilisez un véritable travail antérieur, en modifiant les noms et les chiffres, et non un texte factice rempli de crochets. Notre propre catalogue suit la même règle : chaque Skill est livré avec un exemple de sortie, car c'est le signe le plus clair que quelqu'un a réellement testé l'outil.
Étape 6 : Empaquetez-le et installez-le
Dans Claude (web et ordinateur) : compressez le dossier de sorte qu'il se trouve lui-même à la racine du fichier zip (call-notes.zip contenant call-notes/SKILL.md). Ouvrez la section Skills dans vos paramètres, téléversez le fichier zip et activez le Skill. Démarrez une nouvelle conversation et envoyez une demande correspondant à la description.
Dans Claude Code : aucun fichier zip n'est nécessaire. Placez le dossier dans ~/.claude/skills/ pour l'utiliser dans chaque projet, ou dans .claude/skills/ à l'intérieur d'un dépôt pour le partager avec toutes les personnes qui travaillent sur ce dépôt. Saisissez /call-notes ou décrivez simplement la tâche. Claude Code détecte les modifications apportées au dossier sans redémarrage.
Le guide complet pour chaque interface, y compris l'emplacement des fichiers et la marche à suivre lorsqu'un téléversement est refusé, se trouve dans Comment installer un Skill Claude. Les développeurs qui travaillent principalement dans le terminal devraient également lire Skills Claude Code.
Étape 7 : Testez-le sérieusement
Un Skill qui n'a été essayé qu'une seule fois n'a pas été testé. Effectuez cette vérification avant de le partager avec une équipe :
- Test du déclenchement (5 prompts). Rédigez cinq demandes qui devraient déclencher le Skill, formulées différemment. Comptez combien se déclenchent. Moins de quatre signifie que la description doit reprendre davantage les formulations réelles des utilisateurs.
- Test du silence (5 prompts). Rédigez cinq demandes proches qui ne devraient pas le déclencher. S'il se déclenche pour l'une d'elles, précisez la description.
- Test des entrées manquantes. Donnez-lui la moitié des informations. Il doit poser une question courte ou énoncer ses hypothèses, et non inventer des faits.
- Test de format. Comparez trois sorties côte à côte avec votre exemple. Mêmes sections, même fourchette de longueur, même ton ?
- Test des cas limites. Donnez-lui votre donnée réelle la plus désordonnée : une transcription décousue, une feuille de calcul à moitié vide.
Corrigez la description pour résoudre les problèmes de déclenchement, et le flux de travail ou les règles pour résoudre les problèmes de sortie. Conservez un court journal des modifications au bas du fichier afin de savoir quelle version votre équipe utilise.
Modèle gratuit de compétence Claude (à copier et à adapter)
Remplacez les éléments en majuscules, supprimez ce dont vous n’avez pas besoin et enregistrez le fichier sous le nom SKILL.md dans un dossier portant le même nom que le nom champ.
---
name: nom-de-votre-compétence
description: Produit UN LIVRABLE SPÉCIFIQUE (sections, longueur) à partir de DONNÉES D’ENTRÉE SPÉCIFIQUES. À utiliser lorsque l’utilisateur DEMANDE X, COLLE Y ou mentionne Z. Ne pas utiliser pour UNE TÂCHE SIMILAIRE QUI RELÈVE D’AILLEURS.
---
# TITRE DE VOTRE COMPÉTENCE
## Objectif
Une ou deux phrases : à qui cela s’adresse et à quoi ressemble le résultat attendu.
## Données d’entrée
- Requis : CE QUE L’UTILISATEUR DOIT FOURNIR
- Facultatif : CE QUI AMÉLIORE LE RÉSULTAT
- Si une donnée d’entrée requise manque, posez au maximum deux questions courtes,
puis continuez et indiquez vos hypothèses en haut de la sortie.
## Flux de travail
1. Lisez les données d’entrée et identifiez les ÉLÉMENTS CLÉS.
2. Vérifiez-la par rapport aux RÈGLES OU CRITÈRES.
3. Rédigez la sortie au format ci-dessous.
4. Effectuez le contrôle qualité, corrigez tout problème, puis répondez.
## Format de sortie
- Section 1 : NOM - CE QUI DOIT Y FIGURER (longueur)
- Section 2 : NOM - CE QUI DOIT Y FIGURER (longueur)
- Section 3 : NOM - CE QUI DOIT Y FIGURER (longueur)
Faites correspondre la structure et la longueur du fichier resources/example-output.md.
## Règles
- N’inventez jamais de chiffres, de noms ou de dates. Écrivez plutôt « non fourni ».
- Utilisez un anglais simple. Pas de formules d’introduction superflues.
- RÈGLE SPÉCIFIQUE À VOTRE ÉQUIPE OU À VOTRE SECTEUR.
## Contrôle qualité
- Chaque section est-elle présente et dans le bon ordre ?
- Chaque affirmation est-elle traçable jusqu’aux données d’entrée ?
- Dans la limite de longueur ?
## Journal des modifications
- v1.0 PREMIÈRE VERSION, DATE
Vous voulez voir à quoi ressemblent des compétences terminées ? Exemples de compétences Claude présente douze fichiers SKILL.md réels, ligne par ligne : c’est le moyen le plus rapide de calibrer le niveau de détail nécessaire.
Cinq erreurs qui rendent une compétence inutile
- Une description qui indique ce qu’est la compétence, pas quand l’utiliser. « Un rédacteur publicitaire expert » ne se déclenche jamais. En revanche, « Rédige le texte d’une page produit à partir d’une liste de fonctionnalités lorsque l’utilisateur demande une description de produit, du texte pour une PDP ou du texte d’une fiche produit » fonctionne.
- Une seule compétence pour tout un service. La budgétisation, la paie et l’audit dans un seul fichier vous donnent trois réponses incomplètes. Créez trois compétences.
- Aucun format de sortie. Sans format, chaque exécution est différente et personne ne lui fait confiance.
- Des secrets dans le fichier. Ne collez jamais de clés API, de mots de passe ou de données client dans un Skill. Toute personne avec qui vous le partagez peut le lire.
- Installer sans le lire le Skill de quelqu’un d’autre. Un Skill contient des instructions que Claude suivra, parfois accompagnées de scripts. Lisez-le comme vous liriez un script avant de l’exécuter.
Laissez Claude rédiger le premier brouillon pour vous
Vous n’avez pas besoin de commencer avec un fichier vierge. Claude peut vous interroger sur la tâche, rédiger le frontmatter et le workflow, générer un exemple de résultat et proposer les prompts de test ci-dessus. Anthropic fournit un Skill skill-creator intégré, conçu exactement pour cela, et vous pouvez également le demander en termes simples : "Interrogez-moi sur la façon dont je rédige notre rapport hebdomadaire destiné aux clients, puis rédigez un SKILL.md pour cette tâche." Le brouillon nécessitera vos modifications, en particulier la description et les règles, mais il vous évite l’essentiel de la saisie.
Vous préférez un formulaire à un chat ? Le Claude Skill Builder gratuit transforme une brève description de la tâche en un SKILL.md prêt à l’emploi, avec un frontmatter et un workflow, que vous pouvez copier ou télécharger sous forme de fichier .zip pour Claude.ai et Claude Code. Aucune inscription.
Vous voulez que l’entretien, l’auto-évaluation et la préparation soient réalisés pour vous ? Claude Skill Creator (19 $) est un Skill qui crée des Skills : il vous interroge sur la tâche, les demandes que les utilisateurs saisissent réellement et ce qui ne doit jamais se produire, rédige un dossier de Skill complet avec le SKILL.md et un exemple de résultat, teste la description avec des demandes qui devraient ou non le déclencher et prépare le dossier pour Claude, Claude Code et l’API. Pour auditer un Skill que vous avez écrit ou téléchargé, utilisez le Claude Skill Reviewer & Security Linter, ou obtenez les deux, ainsi que des Skills de révision de prompts, de MCP et de code, dans le Build Your Own Claude Skills Kit (49 $).
Le créer vous-même ou commencer avec un Skill prêt à l’emploi ?
Créez le vôtre lorsque le workflow est propre à votre équipe, qu’il encode des connaissances internes que personne à l’extérieur ne possède ou que vous aimez itérer. Commencez avec un Skill prêt à l’emploi lorsque la tâche correspond à un rôle standard (tenue de livres, briefs SEO, révision de contrats, réponses du support) et que vous préférez consacrer l’après-midi au travail plutôt qu’aux instructions. Un Skill prêt à l’emploi de notre bibliothèque de Skills Claude coûte 19 $, comprend un exemple de résultat et se présente sous la forme d’un simple fichier Markdown que vous pouvez ouvrir et modifier ; il peut donc aussi servir de modèle de départ pour votre propre version.
Dans tous les cas, l’étape suivante est la même : choisissez une tâche que vous répétez chaque semaine, rédigez les deux phrases de l’étape 1 et disposez d’un Skill fonctionnel avant la fin de la journée.