Chapter 6 · Chapitre 6 · Combiner CLAUDE.md et les skills
6.1 Quand utiliser l'un ou l'autre ?
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeTu as maintenant un bon CLAUDE.md. Tôt ou tard, tu vas vouloir y ajouter des procédures : « pour faire une vidéo, d'abord ceci, puis cela… ». C'est le moment de découvrir le duo CLAUDE.md + skill.
Le test en une question
« Est-ce vrai à chaque session, quelle que soit la tâche ? »
- Oui → CLAUDE.md (ton public, ton ton, tes règles de sécurité, l'organisation des dossiers).
- Non, c'est une façon de faire une tâche précise → skill (créer une vidéo, publier un post, trier des factures).
Les signes qu'il te faut un skill
- Tu colles régulièrement la même liste d'étapes dans la conversation.
- Une section de ton CLAUDE.md commence par « Pour faire X : 1… 2… 3… ».
- Ton CLAUDE.md dépasse 200 lignes à cause de procédures détaillées.
- Tu veux pouvoir lancer une tâche d'un seul mot, comme
/video-faceless.
Pourquoi c'est plus efficace
CLAUDE.md est chargé en entier, à chaque session, même quand tu fais autre chose. Un skill ne charge que sa courte description ; son contenu complet arrive seulement quand il sert. Tu peux donc avoir des procédures très détaillées sans encombrer chaque session. Tape /context : tu verras que les descriptions de tes skills occupent peu de place comparé à un long CLAUDE.md.
Créer un skill, en bref
Un skill est un dossier avec un fichier SKILL.md dedans. Pour le projet mes-videos-ia :
.claude/skills/video-faceless/SKILL.md
---
name: video-faceless
description: Crée une vidéo verticale de 40 à 55 s, du script à la publication. À utiliser pour toute demande de vidéo courte.
---
# Les étapes
1. ...
La description est essentielle : c'est elle qui permet à Claude de savoir quand utiliser le skill. Tu peux aussi l'appeler toi-même en tapant /video-faceless. Si tu omets name, la documentation indique que le nom du dossier est utilisé.
Deux emplacements possibles :
.claude/skills/dans le projet : le skill sert dans ce projet (et se partage avec l'équipe) ;~/.claude/skills/: le skill te suit dans tous tes projets.
Bonne nouvelle : quand tu ajoutes ou modifies un skill dans ces dossiers, Claude Code le prend en compte dans la session en cours, sans redémarrage. Seule exception documentée : si le dossier skills lui-même n'existait pas au démarrage, tape /reload-skills.
Écrire une bonne description
Une description efficace dit ce que fait le skill et quand l'utiliser. Compare :
- Floue : « Pour les vidéos. »
- Précise : « Crée une vidéo verticale de 40 à 55 s, du script à la publication. À utiliser pour toute demande de vidéo courte. »
Faire créer le skill par Claude
Dans CLAUDE.md, la section « Fabrication d'une vidéo » est une procédure. Crée un skill .claude/skills/video-faceless/SKILL.md qui reprend ces étapes, avec une description qui dit quoi et quand. Puis retire la procédure de CLAUDE.md et remplace-la par une ligne : « Pour produire une vidéo, utilise le skill video-faceless. » Montre-moi les deux fichiers avant d'écrire.
Si ça coince
- Claude n'utilise pas le skill tout seul : la description ne correspond pas à ta façon de demander. Ajoute les mots que tu utilises (« vidéo », « reel », « short »), ou appelle-le avec
/video-faceless. - Le skill n'apparaît pas dans le menu
/: vérifie le chemin exact (.claude/skills/nom/SKILL.md, avecSKILL.mden majuscules) et l'en-tête entre deux lignes---. - Le skill contredit CLAUDE.md : retire du skill tout ce qui concerne le style et écris « Respecte CLAUDE.md ».
À retenir
- Vrai à chaque session → CLAUDE.md ; façon de faire une tâche → skill.
- Un skill ne charge que sa description tant qu'il ne sert pas.
- La description dit quoi et quand.
- Tu peux appeler un skill directement avec
/nom-du-skill.