Comprendre les Skills de Claude Code
Les Skills de Claude Code transforment tes méthodes de travail en commandes réutilisables. Comment les créer, les organiser et les partager.
Le problème
Tu utilises Claude Code. Il fait le job. Tu lui dis "ajoute un formulaire de contact", il l'ajoute. Tu lui dis "refais-moi cette page en plus épurée", il s'exécute.
Mais tu te répètes. À chaque nouvelle session, les mêmes explications. "Utilise un ton direct, pas de jargon." "Les couleurs du projet sont crème, olive et forest." "Quand tu rédiges, pas de tirets longs, pas d'emojis." Tu as peut-être mis ça dans ton CLAUDE.md, et c'est bien. Mais certaines tâches méritent plus qu'une ligne de convention.
Tu veux que Claude rédige tes articles dans un ton précis. Qu'il analyse un site concurrent avec ta grille à toi. Qu'il génère des briefs créa formatés pour ton équipe. Ça ne rentre pas dans un fichier de config global. Ça mérite son propre espace.
C'est ce que font les Skills.
C'est quoi un Skill Claude Code ?
Un Skill, c'est un mode d'emploi que tu donnes à Claude pour une tâche précise. Pas du code. Pas un plugin. Un fichier texte avec des instructions structurées.
Tu tapes /analyse-concurrence dans Claude Code, il lit les instructions du Skill et s'exécute. Il sait quoi regarder, dans quel ordre, avec quel format de sortie. Tu n'as rien à réexpliquer. C'est le même résultat que si tu avais passé 5 minutes à briefer Claude en début de conversation. Sauf que tu l'as fait une fois pour toutes.
Taper, configurer ou packager ?
Avant de se lancer dans la création d'un Skill, la vraie question c'est : est-ce que tu en as besoin ? Il y a trois façons de donner des instructions à Claude, et chacune a sa place.
Taper dans la conversation
Tu dis "traduis ce mail en anglais" ou "résume cette page". C'est une demande isolée, tu ne la referas pas 10 fois de la même façon. Pas besoin d'écrire quoi que ce soit.
Mettre dans CLAUDE.md
Ton éditorial, couleurs du projet, stack technique, interdits ("jamais d'emojis"). Des règles courtes qui s'appliquent à toutes les conversations du projet, sans que tu aies à y penser. Claude les charge automatiquement à chaque session.
Créer un Skill
Un audit, un brief, une analyse concurrentielle, une rédaction dans un format précis. Un workflow en plusieurs étapes, avec des critères, un ordre, un format de sortie. Quelque chose que tu veux pouvoir déclencher en une commande et obtenir le même résultat à chaque fois.
La frontière entre CLAUDE.md et un Skill, c'est la complexité de la demande. "Ton direct, pas de jargon" tient en une ligne, c'est du CLAUDE.md. "Rédige un article en suivant cette structure, avec cette grille de relecture, ce format de sortie, et ces interdits stylistiques", c'est 30 lignes d'instructions. C'est un Skill.
Le test en 3 questions :
Des exemples concrets :
| Ce que tu veux | Où le mettre |
|---|---|
| "Ton direct, pas de jargon" | CLAUDE.md - règle permanente, 1 ligne |
| "Le projet utilise Next.js et Tailwind" | CLAUDE.md - contexte projet |
| "Jamais de tirets longs ni d'emojis" | CLAUDE.md - interdit permanent |
| "Traduis ce mail en anglais" | Taper directement - ponctuel |
| "Rédige un article avec cette structure et ce ton" | Skill - workflow complet |
| "Audite ce site sur 5 critères et donne un score" | Skill - méthode avec format de sortie |
| "Génère un brief créa pour l'équipe design" | Skill - format réutilisable |
Et pour l'invocation : tu peux lancer un Skill en plein milieu d'une conversation. Pas besoin d'en dédier une. Tu tapes /audit-landing, Claude charge les instructions du Skill et continue la conversation avec ce contexte en plus. C'est comme appeler un collègue expert sur un point précis pendant une réunion.
Ce qu'il te faut
Pré-requis
- Claude Code installé (en CLI, dans VS Code, ou directement sur claude.ai/code)
- Un éditeur de texte. N'importe lequel : VS Code, TextEdit, Notepad, peu importe
- Savoir écrire en markdown. Si tu sais mettre un
#devant un titre et des-devant une liste, c'est suffisant. On en reparle juste en dessousC'est tout. Pas besoin de savoir coder.
Comment créer un Skill : anatomie et structure
Un Skill, c'est un dossier avec un fichier SKILL.md à l'intérieur.
mon-skill/
SKILL.md
Le fichier a deux parties. D'abord le frontmatter, la configuration, entre deux lignes ---. Ensuite le contenu, les instructions que Claude va suivre, écrites en markdown.
Voilà ce que ça donne pour un Skill qui analyse un site web :
---
name: analyse-site
description: Analyse un site web sur le design, le contenu et l'expérience utilisateur
disable-model-invocation: true
allowed-tools: Read, Grep, WebFetch
---
## Ta mission
Analyse le site demandé. Évalue :
1. La clarté du message (on comprend ce que fait le produit en 5 secondes ?)
2. La hiérarchie visuelle (titres, espaces, contrastes)
3. Le parcours utilisateur (de l'arrivée à l'action principale)
4. Le ton éditorial (formel, conversationnel, technique ?)
## Format de sortie
Pour chaque point :
- Constat (ce qui est)
- Verdict (ce qui marche / ce qui coince)
- Suggestion concrète
C'est du markdown. Si tu sais écrire un email un minimum structuré, tu sais écrire un Skill.
C'est quoi le markdown ?
Un format de texte simple utilisé partout dans l'écosystème tech. Les
#font des titres, les**du gras, les-des listes. Tu en as déjà vu dans les README sur GitHub. Aucun logiciel spécial nécessaire, un éditeur de texte suffit.
Configurer un Skill : le frontmatter en 4 lignes
Quatre champs, pas plus, et tu couvres 90% des cas :
- name : le nom de ton Skill. C'est aussi ta commande slash.
analyse-sitedonne/analyse-site. - description : ce que fait le Skill. Important : Claude utilise cette description pour décider s'il doit l'invoquer tout seul. Plus c'est précis, mieux il décide.
- disable-model-invocation :
truesi tu veux garder le contrôle. Claude ne lancera le Skill que quand tu le lui demandes explicitement. - allowed-tools : les outils autorisés sans te demander la permission.
Read, Greppour de la lecture. AjouteWebFetchs'il doit aller sur le web.
Il existe d'autres champs (choix du modèle, niveau d'effort, exécution isolée) mais on n'en a pas besoin pour démarrer.
Comment invoquer un Skill
Tu tapes la commande slash :
/analyse-site
Claude charge les instructions du Skill. Il te demande ce qu'il lui manque, ici l'URL du site à analyser. Tu la donnes, il déroule l'analyse point par point, exactement comme tu l'as défini.
Et parfois, tu n'as même rien à taper. Si ton Skill a une bonne description et que l'invocation automatique est active, Claude le détecte tout seul. Tu lui dis "donne-moi ton avis sur le site de tel concurrent", il trouve ton Skill d'analyse et l'applique.
La règle de bon sens : si le Skill modifie des fichiers, publie quelque chose, ou a un quelconque effet de bord, garde le contrôle avec disable-model-invocation: true. Si c'est de la lecture, de l'analyse ou de la rédaction, laisse Claude décider.
Aller plus loin : passer des arguments
Tu peux injecter des informations directement dans la commande. Le Skill les récupère via $ARGUMENTS.
Exemple : un Skill qui génère un brief créatif.
---
name: brief-design
description: Génère un brief créatif structuré pour l'équipe design
disable-model-invocation: true
---
## Brief créatif
Crée un brief design sur le sujet suivant : $ARGUMENTS
Structure du brief :
- Contexte et objectif
- Cible utilisateur
- Direction artistique souhaitée
- Contraintes techniques (formats, responsive, accessibilité)
- 3 références d'inspiration (cherche sur le web)
L'invocation :
/brief-design refonte de la page pricing pour le segment PME
Claude reçoit toute la phrase après la commande et génère le brief complet. La structure est toujours la même, seul le sujet change. Tu produis un brief en 30 secondes au lieu de 10 minutes.
Tu peux aussi découper les arguments par position quand tu as plusieurs entrées distinctes :
---
name: compare-sites
description: Compare deux sites web sur le design et le contenu
---
Compare ces deux sites :
- Site A : $ARGUMENTS[0]
- Site B : $ARGUMENTS[1]
Pour chaque critère (clarté du message, design, parcours utilisateur, ton éditorial),
indique lequel est le plus efficace et pourquoi.
/compare-sites https://stripe.com https://lemonsqueezy.com
Faire écrire un Skill par Claude
Tu n'as pas besoin d'écrire le fichier SKILL.md toi-même. Claude Code sait le faire, et il le fera mieux si tu lui donnes les bonnes infos.
Le workflow en 3 étapes :
1. Explique ce que tu fais manuellement
En langage naturel. Décris ta méthode comme tu l'expliquerais à un collègue. Les étapes, les critères, ce que tu regardes, dans quel ordre.
2. Montre un exemple de résultat
Colle un vrai output qui t'a plu. "La dernière fois, le résultat ressemblait à ça." C'est l'info la plus précieuse : Claude comprend le format attendu et le niveau de détail.
3. Demande-lui de créer le Skill
Claude génère le dossier, le fichier SKILL.md, le frontmatter, tout. Tu testes, tu ajustes.
Voilà ce que ça donne en pratique :
Il évalue 4 critères (clarté, hiérarchie, parcours, ton) et produit un constat + verdict + suggestion pour chacun. J'ai ajouté
WebFetch dans les outils autorisés pour qu'il puisse aller lire le site.Claude a tout ce qu'il faut pour produire une V1 solide. Ensuite tu le testes, tu vois ce qui manque, tu ajustes le SKILL.md. C'est itératif.
Les infos qui comptent pour un bon Skill :
| Information | Pourquoi c'est important |
|---|---|
| L'objectif en une phrase | Claude sait quoi faire sans deviner |
| Les étapes dans l'ordre | Il suit ta méthode, pas la sienne |
| Le format de sortie | Le résultat est structuré comme tu le veux |
| Les contraintes (ton, longueur, interdits) | Il évite les faux pas dès la V1 |
| Un exemple de bon résultat | Vaut mieux que 10 lignes de description |
