Skip to content
Floskool

Chapter 6 · Chapitre 6 · Combiner CLAUDE.md et les skills

6.1 Quand utiliser l'un ou l'autre ?

Free lesson 6 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Tu 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, avec SKILL.md en 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.