Créer une skill Claude : 6 étapes et un exemple SKILL.md

Les skills en une minute

Une skill Claude est un dossier d'instructions, un fichier SKILL.md accompagné d'exemples et de scripts facultatifs, que Claude charge de lui-même quand votre demande correspond à la description de la skill. Vous écrivez une procédure une fois au lieu de la coller dans chaque conversation, et un ancien fichier de commande slash personnalisée, comme .claude/commands/review.md, fonctionne toujours, car les commandes slash sont désormais des skills elles aussi.

Les skills utilisent le format ouvert Agent Skills, donc le même dossier fonctionne dans Claude Code, les applis Claude et l'API Claude. Pour une réponse plus complète à la question de ce que sont les skills Claude, avec des skills toutes prêtes à installer, parcourez notre annuaire des skills Claude. Les skills sont la leçon 3 de notre formation Claude gratuite, qui couvre aussi les Projects, les connecteurs et les tâches.

Skills Claude vs MCP, plugins et CLAUDE.md

Le centre d'aide d'Anthropic résume simplement la différence entre skills et MCP : MCP donne à Claude l'accès à un outil, et une skill apprend à Claude à bien s'en servir, donc les deux fonctionnent mieux ensemble. Pour les autres cartes, voyez que mettre dans un fichier CLAUDE.md et ce qu'est un serveur MCP.

Comment les skills se chargent, et pourquoi la description compte le plus

La présentation des Agent Skills d'Anthropic décrit un système de chargement à trois niveaux qu'elle appelle la divulgation progressive. Un token, dans ces chiffres, est le petit morceau de texte que comptent les modèles d'IA, souvent un mot court ou une partie d'un mot plus long.

Première leçon : Claude décide d'ouvrir une skill à partir de son seul nom et de sa description. Quand plusieurs skills ou outils pourraient faire le travail, c'est celle dont la description reprend vos mots qui l'emporte.

Deuxième leçon : chaque skill installée coûte un peu d'attention à chaque tour, donc quelques skills bien utilisées valent mieux qu'une longue liste oubliée.

Où sont stockées les skills Claude

Le signe ~ désigne votre dossier personnel : /Users/votrenom sur Mac et C:\Users\votrenom sur Windows, donc une skill personnelle sur Windows se trouve dans C:\Users\votrenom\.claude\skills\. Le dossier .claude est masqué par défaut : appuyez sur Cmd + Maj + . dans le Finder, ou cochez Hidden items sous View dans l'Explorateur de fichiers. Si une skill personnelle et une skill de projet portent le même nom, c'est la personnelle qui l'emporte.

Comment créer une skill Claude, pas à pas

L'exemple est l'une des skills Claude pour le marketing les plus simples à construire : un rédacteur de briefs de campagne pour un marketeur qui en produit un chaque semaine. Elle rassemble d'abord les informations manquantes, rédige le brief selon une structure fixe et vérifie son propre travail avant de le rendre.

Étape 1 : écrivez la procédure que vous suivez déjà

Étape 2 : créez le dossier de la skill

Le plus simple est de demander à Claude Code de le faire :

Crée un dossier de skill personnelle appelé campaign-brief dans mon répertoire de skills (~/.claude/skills/) avec un fichier SKILL.md vide à l'intérieur.

Si vous préférez le taper vous-même, utilisez le Terminal sur Mac :

$ mkdir -p ~/.claude/skills/campaign-brief
$ 

Ou PowerShell sur Windows :

PS> New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\campaign-brief"
PS> 

Étape 3 : écrivez le fichier SKILL.md

Créez SKILL.md dans le dossier et collez ceci. La partie entre les deux lignes --- est le frontmatter, un petit bloc de réglages écrit en YAML (un format simple « clé: valeur »), et tout ce qui suit constitue les instructions.

---
name: campaign-brief
description: Rédige un brief de campagne d'une page depuis des notes. À utiliser pour un brief de campagne, un brief créatif ou le plan d'un lancement, d'une promo ou d'une campagne e-mail.
---

# Brief de campagne

## Avant de rédiger
Vérifie que tu as ces informations. Demande tout ce qui manque dans une courte liste, puis attends :
- Produit ou offre, et son prix s'il y en a un
- Audience : qui ils sont et le problème qu'ils ont
- Objectif : un résultat mesurable, comme des démos réservées ou des premiers achats
- Canaux et date limite
- Budget, ou « aucun »

## Rédiger le brief
Utilise exactement ces sections, dans cet ordre :
1. Résumé (trois phrases maximum)
2. Audience et sa principale objection
3. Message clé et trois arguments
4. Offre et appel à l'action
5. Canaux, avec une ligne sur le rôle de chacun
6. Calendrier avec dates
7. Comment nous mesurerons le succès
8. Questions ouvertes

Si brand/voice.md existe dans ce projet, lis-le d'abord et suis-le.
Enregistre le brief sous briefs/AAAA-MM-JJ-nom-de-campagne.md.

## Règles
- N'invente jamais de chiffres, prix, dates ou témoignages. Écris [À DÉFINIR] à la place.
- Tiens sur une page, environ 450 mots.
- Utilise les mots de l'audience, pas le jargon marketing.

## Avant de terminer
Relis le brief et confirme que chaque section est remplie ou marquée [À DÉFINIR], que l'objectif est mesurable et que l'appel à l'action correspond à l'offre. Liste chaque [À DÉFINIR] à la fin.

Claude Code lui-même n'a besoin que de la description ; sans name, c'est le nom du dossier qui devient la commande. L'appli Claude exige les deux, alors écrivez les deux et un seul fichier fonctionne partout.

Étape 4 : ajoutez un fichier d'appui

Collez un brief dont vous êtes fier dans examples.md dans le même dossier, puis ajoutez une ligne sous « Rédiger le brief » : « Pour le ton et le niveau de détail, voir examples.md. » Claude ne lit l'exemple que lorsqu'il lance la skill, donc il ne coûte rien le reste du temps. Anthropic conseille de garder SKILL.md sous 500 lignes et de déplacer les longs documents de référence dans des fichiers comme celui-ci.

campaign-brief/
  SKILL.md
  examples.md

Étape 5 : testez-la de deux façons

Ouvrez Claude Code dans n'importe quel dossier de projet. S'il tournait déjà et que le dossier de skills est tout neuf, lancez d'abord /reload-skills.

D'abord, le test automatique : demandez avec des mots simples et regardez Claude prendre la skill.

Nous avons fait exactement cela dans un dossier de projet avec la skill ci-dessus. La première ligne de la réponse de Claude montre la skill qui se charge, et, comme la skill le demande, il a réclamé les informations manquantes avant d'écrire quoi que ce soit (cet écran est l'image en haut de ce guide). Nous avons répondu avec l'offre, l'objectif et la date d'envoi, et il a enregistré le brief puis listé ce qui restait ouvert :

Ensuite, le test direct : tapez /campaign-brief e-mail soldes de fin d'année, et le texte après le nom de la skill est transmis comme arguments. Pour confirmer que Claude voit bien la skill, demandez « Quelles skills sont disponibles ? » ou lancez /skills.

Ce qu'ont donné nos 18 tests de déclenchement

Nous avons lancé exactement cette skill sur Claude Code 2.1.303 avec Opus 5.5 en octobre 2026, chaque demande dans une nouvelle session, à côté d'environ 90 autres skills installées, dont une skill de brief de contenu SEO :

Chaque déclenchement a réclamé l'offre, l'objectif et les dates manquants au lieu de les inventer : la section « Avant de rédiger » en action.

Nous avons ensuite réduit la description à « Assistant pour documents marketing. », puis renommé aussi la skill mkt-helper. Les deux versions se sont quand même chargées sur les quatre demandes de brief et de plan, et ont ignoré une demande de légende et une demande d'e-mail de remerciement. Lors d'un essai, cependant, Claude s'est d'abord tourné vers un outil de documents connecté.

Étape 6 : ajustez-la

Attendez-vous à quelques allers-retours. Claude Code prend en compte les modifications des fichiers d'une skill pendant la session : modifiez, enregistrez et réessayez.

• Elle ne se déclenche jamais : ajoutez à la description les mots que vous utilisez vraiment, et vérifiez si la description d'une autre skill revendique la même tâche.
• Elle se déclenche quand vous ne le voulez pas : resserrez la description, ou ajoutez disable-model-invocation: true pour que la skill ne se lance que lorsque vous tapez sa commande.
• Elle fait mal deux tâches : séparez-la en une skill par tâche, chacune avec sa propre description.
• Elle oublie une règle en fin de longue session : remontez cette règle en haut. Quand une longue conversation est compactée, Claude Code ne rattache que les 5 000 premiers tokens de chaque skill.

Envie d'aide pour l'ajustement ? Le plugin Skill Creator d'Anthropic s'installe avec /plugin install skill-creator@claude-plugins-official. Demandez-lui d'évaluer votre skill : il lance des prompts de test avec et sans la skill, puis suggère des modifications de la description.

Les réglages facultatifs du frontmatter SKILL.md

Ignorez-les tant que votre première skill ne fonctionne pas.

Dans les instructions, $ARGUMENTS indique où doit aller le texte que vous tapez après la commande.

Comment faire une skill Claude sans écrire le fichier

Vous n'êtes pas obligé de taper SKILL.md vous-même. Claude peut le rédiger à trois endroits :

Transforme ce que nous venons de faire en une skill appelée [NOM-DE-LA-SKILL]. Garde les étapes qui ont marché, ajoute chaque correction que je t'ai donnée comme une règle, et écris une description de moins de 200 caractères qui liste les expressions que j'utiliserais pour demander cette tâche. Montre-moi le SKILL.md avant de l'enregistrer.

Faire la tâche d'abord compte : vos corrections en cours de route deviennent les règles de la skill. Lisez le brouillon avant de l'activer.

Comment importer une skill dans Claude (appli web et de bureau)

Les skills fonctionnent aussi dans les applis Claude web et de bureau, sur les offres Free, Pro, Max, Team et Enterprise, avec la configuration décrite dans l'article d'aide sur l'utilisation des skills d'Anthropic :

1. Activez l'exécution de code. Sur les offres Free, Pro et Max, ouvrez Settings > Capabilities et activez Code execution and file creation. Sur les offres Team et Enterprise, un propriétaire l'active pour l'organisation.
2. Compressez le dossier. Le dossier lui-même doit être à la racine du fichier zip : campaign-brief.zip contient campaign-brief/SKILL.md.
3. Importez-le. Ouvrez Customize > Skills, cliquez sur +, choisissez Create skill, puis Upload a skill.
4. Activez-la et testez. Essayez quelques prompts qui devraient la déclencher.

Sur Mac, un zip à la bonne structure s'obtient en faisant un clic droit sur le dossier campaign-brief lui-même et en choisissant Compress. Sur Windows, faites un clic droit sur le dossier et choisissez Compress to ZIP file (Windows 11) ou Send to > Compressed (zipped) folder (Windows 10). Compresser les fichiers à l'intérieur du dossier au lieu du dossier lui-même est la cause d'échec d'import la plus fréquente.

Installer des skills Claude depuis GitHub et des plugins

Le dépôt public de skills d'Anthropic sur GitHub, une bonne source d'exemples de skills Claude, fonctionne aussi comme une marketplace. Ces deux commandes l'ajoutent et installent ses skills d'exemple, qui incluent des chartes de marque, la co-rédaction de documents et des skills de design comme Canvas Design :

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

Claude Code vous demande ensuite une portée : vous seul, tout le monde sur ce projet, ou vous seul dans ce projet. Dans l'appli Claude, vous activez les mêmes skills d'exemple dans Customize > Skills.

Vérifiez une skill avant de lui faire confiance

Une skill peut demander à Claude d'exécuter des commandes et de lire des fichiers, alors traitez son installation comme celle d'un logiciel. La documentation d'Anthropic conseille d'examiner toute skill que vous n'avez pas écrite vous-même ou obtenue auprès d'Anthropic.

Une skill Claude qui ne fonctionne pas ? Problèmes fréquents et solutions

Que faire maintenant

Choisissez une tâche que vous avez expliquée à Claude plus de deux fois ce mois-ci et transformez-la en skill aujourd'hui, en prenant le brief de campagne comme modèle. Testez-la avec trois formulations différentes avant de compter dessus.

Pour des idées qui méritent d'être empaquetées, les workflows de Claude Code pour les marketeurs se transforment bien en skills. Si vous voulez une mise en place guidée des skills, de MCP et du CLAUDE.md ensemble, la formation Claude Code couvre les trois dans son module de configuration.