Les skills de Claude Code : comprendre et créer les tiens

Un skill, c’est un dossier qui contient un fichier SKILL.md : des instructions que tu écris une fois et que Claude Code ressort quand il en a besoin. Claude le charge tout seul quand ta demande correspond à sa description, ou tu le lances toi-même en tapant /nom-du-skill. Crée-en un dès que tu colles la même procédure dans la conversation pour la troisième fois.

Plus bas : un skill complet à copier, puis deux skills que j’utilise vraiment sur mes projets clients. Si Claude Code n’est pas encore installé chez toi, commence par l’installer.

Ce qu’est un skill, concrètement

Le nom du dossier devient la commande : un dossier point-client donne /point-client. Dedans, un seul fichier est obligatoire, SKILL.md. Il a deux parties. En haut, le frontmatter : quelques lignes de réglages entre deux lignes ---. En dessous, les instructions, en Markdown, c’est-à-dire du texte simple avec # devant les titres.

Un skill peut apporter un savoir (ton guide de style, les conventions d’un client) ou décrire une tâche étape par étape (déployer, publier, rédiger un compte rendu).

Comment Claude décide de s’en servir

À chaque session, Claude Code place dans le contexte le nom et la description de chaque skill. Le contexte, c’est tout ce que Claude a sous les yeux : ta conversation, les fichiers lus, tes instructions. Le reste du SKILL.md n’y entre que quand le skill sert.

Claude compare donc ta demande aux descriptions. Si elles sont vagues ou se chevauchent, il peut prendre le mauvais skill ou rater le bon. Pour être sûr, tape / suivi du nom, au début de ton message. Écrit au milieu d’une phrase, le nom autorise Claude à utiliser le skill, mais ne le lance pas.

C’est la grande différence avec le fichier CLAUDE.md, chargé en entier à chaque session : un long skill ne coûte presque rien tant qu’il ne sert pas.

Où ranger tes skills

Un skill de projet est enregistré avec le dépôt, le dossier suivi par git : tous ceux qui récupèrent le projet le reçoivent. À nom égal, ton skill personnel l’emporte sur celui du projet.

Claude Code surveille ces dossiers : un skill ajouté ou modifié est pris en compte sans redémarrer. Si tu crées un dossier de skills qui n’existait pas au lancement, tape /reload-skills. La commande /skills liste tous les skills disponibles.

Créer ton premier skill, pas à pas

L’exemple : un skill qui rédige le point d’avancement pour ton client, à partir de ce qui a été fait dans le projet. Le mail que tout freelance écrit chaque semaine.

1. Crée le dossier

Sur Mac, Linux ou WSL :

mkdir -p ~/.claude/skills/point-client

Sous Windows, dans PowerShell :

mkdir "$HOME\.claude\skills\point-client"

2. Écris le fichier SKILL.md

Crée SKILL.md dans ce dossier et colle ceci :

---
name: point-client
description: Rédige le point d’avancement à envoyer au client à partir des commits récents et du PROJET.md. À utiliser quand l’utilisateur demande un point client, un récap de la semaine, un mail d’avancement ou un compte rendu de livraison.
argument-hint: "[période, ex. 14 jours]"
---

# Point d’avancement client

Période à couvrir : $ARGUMENTS (si rien n’est indiqué : les 7 derniers jours).

## Étapes

1. Lis les commits de la période avec `git log --oneline --since="7 days ago"` (adapte la durée).
2. Lis `PROJET.md` s’il existe : feuille de route et problèmes connus.
3. Classe le travail en trois rubriques : ce qui est fait, ce qui vient ensuite, ce que j’attends du client (textes, photos, accès, validations).
4. Rédige l’e-mail en français, en vouvoyant le client, en moins de 200 mots, sans jargon technique.

## Règles

- N’écris que ce qui figure dans les commits ou dans PROJET.md. Rien d’inventé.
- Aucune date de livraison que je n’ai pas donnée : écris [DATE À CONFIRMER].
- N’envoie rien. Affiche le brouillon, puis la liste de ce que je dois vérifier avant l’envoi.

Ce qu’il faut comprendre :

• name donne la commande. Sans lui, Claude Code prend le nom du dossier.
• description compte plus que tout le reste : ce que fait le skill et quand l’utiliser, avec les mots que tu emploies vraiment. Mets le cas principal en premier : au-delà de 1 536 caractères, elle est coupée.
• argument-hint s’affiche dans le menu pour rappeler quoi ajouter après la commande. Mon skill de rédaction de textes de site affiche, lui, [chemin du brief client].
• $ARGUMENTS est remplacé par ce que tu tapes après la commande : /point-client 14 jours couvre deux semaines.

3. Teste-le

Ouvre une nouvelle session dans un projet client et écris « fais-moi le point pour le client » : Claude devrait charger le skill. Ou lance-le directement avec /point-client. Une nouvelle session, parce que celle où tu as écrit le skill sait déjà ce que tu veux : elle masque les trous des instructions.

4. Ajuste

Il ne se déclenche pas ? Ajoute à la description les mots que tu as utilisés. Il se déclenche trop souvent ? Rends-la plus précise.

Pour un skill qui agit (déployer, envoyer, publier), ajoute disable-model-invocation: true au frontmatter : toi seul pourras le lancer. Comme le dit la documentation, tu ne veux pas que Claude décide de déployer parce que ton code a l’air prêt.

Tu peux aussi demander à Claude Code d’écrire le skill, juste après une tâche faite ensemble : « crée un skill qui reprend ce qu’on vient de faire ». Relis, et coupe ce qui ne sert pas.

Deux skills que j’utilise vraiment

Mettre en ligne l’aperçu d’un site client

Le premier met en ligne l’aperçu d’un site client sur mon serveur, en une passe. Il se lance avec /deploy-maquette, ou par une phrase comme « je veux montrer ça au client » : sa description contient ces formulations.

Le SKILL.md fait un peu moins de 100 lignes, sans script. Après la préparation et le déploiement vient une étape intitulée « jamais annoncer sans preuve » : Claude vérifie le site réellement servi. Code de réponse de chaque page, sitemap.xml, robots.txt, une vraie page 404, puis un passage au navigateur pour les erreurs et l’affichage mobile.

Une section « Pièges vécus » termine le fichier : des problèmes rencontrés sur de vrais déploiements, avec leur parade. Par exemple, des vidéos illisibles sur Safari à cause d’une compression mal placée. Une fois le piège noté, Claude le relit à chaque déploiement. Aucune clé d’accès dans le skill : il indique seulement le fichier où la lire au moment de l’appel.

Le contrôle qualité avant livraison

Le second contrôle un site entier à partir d’une seule adresse et rend un rapport PDF avec une liste de tâches. Sa structure :

SKILL.md      le déroulé en six étapes (55 lignes)
scripts/      cinq scripts Python : parcourir le site, relever ce qu’il expose,
              le tester au navigateur, analyser les mesures, construire le PDF
reference/    la grille de gravité et le format du rapport
template/     la mise en page du rapport
assets/       le logo et un script de pagination

Le SKILL.md reste court et renvoie vers reference/ au moment de rédiger. Les scripts sont exécutés sans être lus : seul leur résultat entre dans le contexte. Le principe tient en une ligne du skill : « les scripts mesurent, l’agent juge ». Chaque défaut visuel est confirmé deux fois avant d’entrer dans le rapport.

Skill, CLAUDE.md, commande, sous-agent, hook : lequel pour quoi

Un sous-agent travaille à part, dans son propre contexte, et ne rapporte qu’un résumé. Un hook est un script que Claude Code exécute à un moment précis, quoi que Claude décide.

Le repère de la documentation : une erreur répétée va dans le CLAUDE.md, une procédure recollée devient un skill, ce qui doit arriver à chaque fois devient un hook. Une consigne comme « ne jamais modifier .env », écrite dans un CLAUDE.md ou un skill, reste une demande, pas une garantie.

CLAUDE.md et skills se complètent : quand ton CLAUDE.md dépasse les 200 lignes conseillées, déplace le contenu de référence dans des skills.

Écrire un bon skill : ce que conseille Anthropic

• Une description précise, à la troisième personne : « Rédige le point… », pas « Je peux t’aider à… ». « Aide avec les documents » ne permet pas à Claude de choisir.
• Un contenu court. Claude est déjà très compétent : n’écris que ce qu’il ne sait pas. Reste sous 500 lignes.
• Les détails à part, dans des fichiers annexes cités directement depuis le SKILL.md. Claude ne les lit qu’au besoin : c’est la divulgation progressive.
• Des scripts pour ce qui doit être exact : plus fiables qu’un code réécrit à chaque fois.
• L’essentiel en haut : quand une longue conversation est résumée, Claude Code peut ne garder que le début d’un skill.

J’ajoute une règle à moi : aucun secret dans un skill, surtout un skill de projet, qui voyage avec le dépôt. Et avant de lancer Claude Code dans un projet que tu n’as pas écrit, regarde son dossier .claude/skills/ : un skill peut s’autoriser des outils sans te demander, avec le champ allowed-tools.

Trouver des skills tout faits

Claude Code arrive avec des skills intégrés, comme /code-review ou /debug. Pour aller plus loin, il y a les plugins : des skills, sous-agents, hooks ou connexions à des services, installés en une fois depuis une marketplace, un catalogue de plugins.

La marketplace officielle d’Anthropic est ajoutée au premier lancement dans un terminal : tape /plugin et ouvre l’onglet Discover. Pour tester et améliorer tes propres skills, il y a par exemple :

/plugin install skill-creator@claude-plugins-official

Quelle que soit la marketplace, un plugin peut exécuter du code avec tes droits : regarde ce qu’il contient avant de l’installer.

Par où commencer

Pendant une semaine, note ce que tu réexpliques à Claude Code. La consigne valable partout va dans ton CLAUDE.md. La procédure que tu recolles devient ton premier skill. Un seul pour commencer, testé sur un vrai projet.

Et si tu pars de zéro côté CLAUDE.md : mon CLAUDE.md commenté, 7 règles à copier, offert à l’inscription à « La Ligne de commande », ma newsletter gratuite.

Article écrit avec Claude Code à partir de la documentation officielle d’Anthropic, vérifiée le 12 octobre 2026, et de mes propres skills.