Skip to content
Floskool

Chapter 2 · Chapitre 2 · Découvrir CLAUDE.md

2.3 CLAUDE.md ou skill : quelle différence ?

Free lesson 5 minGroup Claude Code & IA

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

Follow for free

Les deux sont des fichiers d'instructions écrits en Markdown, mais ils ne servent pas à la même chose. Comprendre la différence, c'est garder un CLAUDE.md court et des procédures détaillées.

CLAUDE.md, en résumé

  • Répond à : « Qui je suis, comment on travaille ici. »
  • Chargement : en entier, au début de chaque session.
  • Taille conseillée : moins de 200 lignes.
  • Exemple : « Public : débutants. Ton : direct. Jamais de chiffres inventés. »
  • Emplacement : ./CLAUDE.md.

Le skill, en résumé

  • Répond à : « Comment on fait cette tâche précise. »
  • Chargement : seule sa description est connue au départ ; le contenu complet se charge quand le skill est utilisé.
  • Taille conseillée : moins de 500 lignes pour le fichier principal (le reste dans des fichiers à côté).
  • Exemple : « Pour créer une vidéo : 1. script, 2. voix, 3. montage, 4. publication. »
  • Emplacement : .claude/skills/nom-du-skill/SKILL.md pour un projet, ou ~/.claude/skills/nom-du-skill/SKILL.md pour tous tes projets.

Le conseil de la documentation officielle

Crée un skill quand tu colles sans arrêt les mêmes étapes ou la même checklist dans la conversation, ou quand une partie de ton CLAUDE.md est devenue une procédure plutôt qu'un fait. Avantage : un skill ne coûte presque rien tant qu'il n'est pas utilisé, puisque seule sa description occupe le contexte.

Un exemple pour sentir la différence

  • « Mes vidéos durent entre 40 et 55 secondes » → c'est un fait sur ton projet : CLAUDE.md.
  • « Pour fabriquer une vidéo, écris d'abord le script, attends ma validation, puis génère la voix… » → c'est une procédure : skill.
  • « Les scripts sont rangés dans video-XX/ » → c'est un fait : CLAUDE.md.
  • « Pour publier : prépare la légende par réseau, crée un brouillon, attends mon accord » → procédure : skill.

À quoi ressemble un skill minimal

Un skill est un dossier qui contient un fichier SKILL.md. En haut, un en-tête (appelé frontmatter, entre deux lignes ---) donne son nom et sa description :

---
name: script-video
description: Écrit le script d'une vidéo courte du projet mes-videos-ia. À utiliser quand je demande un script ou une nouvelle vidéo.
---
1. Propose 3 hooks et attends mon choix.
2. Écris le script en respectant CLAUDE.md.
3. Montre-moi le script avant de créer le fichier.

La description est ce que Claude lit pour décider quand utiliser le skill. Tu peux aussi l'appeler toi-même en tapant /script-video. Note que le skill dit « en respectant CLAUDE.md » : il ne répète pas tes règles de style, il s'appuie dessus.

Le test rapide

Pose-toi la question : « Est-ce que c'est vrai à chaque session, quelle que soit la tâche ? »

  • Oui → CLAUDE.md.
  • Non, ça décrit comment faire une tâche → skill.

On verra au chapitre 6 comment les faire travailler ensemble, avec un workflow complet.

Si ça coince

  • Ton CLAUDE.md grossit à cause de listes d'étapes : déplace chaque procédure dans un skill et garde une ligne dans CLAUDE.md si besoin.
  • Claude n'utilise pas ton skill : sa description est trop vague. Précise ce qu'il fait et quand l'utiliser, ou appelle-le directement avec /nom-du-skill.
  • Le skill répète les règles de CLAUDE.md : supprime les doublons et écris « Respecte CLAUDE.md » à la place.

À retenir

  • CLAUDE.md contient des faits et des règles vrais à chaque session.
  • Un skill contient une procédure, chargée seulement quand elle sert.
  • La description d'un skill décide quand Claude l'utilise.
  • Un skill s'appuie sur CLAUDE.md au lieu de le répéter.