Comment créer une skill Claude : SKILL.md pas à pas (2026)

Une skill Claude est un dossier avec un seul fichier obligatoire, SKILL.md : un court en-tête qui dit ce que fait la skill et quand l'utiliser, suivi d'instructions en langage courant. Voici comment créer une skill Claude dans Claude Code : créez un dossier dans ~/.claude/skills/, écrivez un SKILL.md avec un name et une description, puis demandez la tâche avec vos propres mots ou tapez / suivi du nom de la skill. Ci-dessous, vous allez construire une skill fonctionnelle pour un marketeur, comprendre comment Claude décide de la charger, et installer des skills créées par d'autres.

Ce qu'est une skill Claude, en langage simple

Voyez une skill comme une procédure enregistrée que Claude sort du placard quand la tâche le demande. Au lieu de coller les mêmes instructions dans chaque conversation, vous les écrivez une fois dans un fichier, et Claude ne les ouvre que lorsque votre demande correspond.

Les skills utilisent le format ouvert Agent Skills, qu'Anthropic a conçu et publié comme standard. Un dossier de skill est portable : Claude Code, les applis Claude et l'API Claude l'acceptent tous, et ce guide se concentre sur Claude Code, où les skills sont de simples fichiers.

Les utilisateurs existants doivent savoir que Claude Code a fusionné les commandes slash personnalisées avec les skills. Un ancien fichier .claude/commands/review.md fonctionne toujours, mais un dossier de skill peut aussi contenir des modèles, des exemples et des scripts.

Pour la première et la troisième carte, 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 : la description est le déclencheur. Si elle ne contient pas les mots que vous utilisez naturellement pour demander la tâche, Claude ne prendra pas la skill.

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ù vivent les skills

Le signe ~ désigne votre dossier personnel : /Users/votrenom sur Mac et C:\Users\votrenom sur Windows. Si une skill personnelle et une skill de projet portent le même nom, c'est la personnelle qui l'emporte.

Créer une skill de brief de campagne, pas à pas

L'exemple est une skill pour un marketeur qui rédige un brief de campagne 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 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 marketing d'une page. À 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.

É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.

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.

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.

É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.
• 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 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 garde que le début de chaque skill qu'il rattache.

Les réglages facultatifs à connaître

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.

Utiliser la même skill dans l'appli Claude

Les skills fonctionnent aussi dans les applis Claude web et de bureau, 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.

Le centre d'aide indique une limite de 200 caractères pour la description sur claude.ai, une raison de plus de la garder concise. L'exemple ci-dessus tient dans cette limite.

Installer des skills créées par d'autres

Vous n'êtes pas obligé d'écrire chaque skill vous-même :

Le dépôt public de skills d'Anthropic (voyez celles que nous avons testées dans notre annuaire de skills) 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.

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 de n'utiliser que des skills de sources fiables, c'est-à-dire écrites par vous ou fournies par Anthropic, et d'examiner minutieusement toutes les autres.

Dépannage

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, et l'annuaire des skills Claude montre ce que d'autres ont créé. 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.