Chapitre 6 · Chapitre 6 · Combiner CLAUDE.md et les skills
6.2 Organiser les instructions de ton projet
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementVoici une organisation claire, de la plus générale à la plus précise :
~/.claude/CLAUDE.md ← toi partout : langue, ton, façon de travailler
mon-projet/
CLAUDE.md ← le projet : audience, style, règles, dossiers
CLAUDE.local.md ← tes notes perso sur ce projet (dans .gitignore)
.claude/
rules/
site.md ← règles chargées seulement pour certains fichiers (paths)
skills/
video-faceless/SKILL.md ← procédure : créer une vidéo
publication/SKILL.md ← procédure : publier sur les réseaux
Qui contient quoi
~/.claude/CLAUDE.md: « Réponds en français. Explique simplement. Demande avant de supprimer. »mon-projet/CLAUDE.md: « Public : débutants. Vidéos de 40 à 55 s. Jamais de chiffre inventé. »CLAUDE.local.md: « Mon dossier de rushs est sur le disque D:. ».claude/rules/site.md: « Pages HTML : une seule balise h1. » (avecpaths)skills/video-faceless: les 4 étapes de fabrication, avec validations.skills/publication: la préparation des légendes par réseau et la création d'un brouillon.
Ce qui est chargé, et quand
- Au démarrage :
~/.claude/CLAUDE.md,CLAUDE.mddu projet,CLAUDE.local.md, les règles sanspaths, et les descriptions des skills. - Quand Claude ouvre un fichier qui correspond : les règles avec
pathset les CLAUDE.md des sous-dossiers. - Quand un skill sert : le contenu complet de son
SKILL.md.
Cette organisation garde le démarrage léger tout en rendant disponibles des procédures très détaillées.
Un exemple de parcours complet
Tu lances Claude Code dans mes-videos-ia et tu demandes « Fais une vidéo sur les agents IA ». Au démarrage, Claude a déjà ton fichier personnel (français, explications simples), le CLAUDE.md du projet (public débutant, 40 à 55 secondes) et ta note locale (rushs sur D:). Il reconnaît dans les descriptions que le skill video-faceless correspond, charge ses étapes, et s'arrête à chaque validation. Si, pendant le montage, il ouvre une page HTML du dossier site/, la règle site.md se charge à ce moment-là seulement. Chaque fichier joue son rôle, sans doublon.
Les deux règles d'organisation
- Ne jamais dupliquer une règle à deux endroits : en cas de changement, tu en oublierais un.
- Le skill s'appuie sur CLAUDE.md au lieu de le répéter : « Respecte le style défini dans CLAUDE.md. »
Migrer pas à pas un CLAUDE.md trop chargé
Si ton fichier actuel mélange tout, voici l'ordre à suivre :
- Repère les procédures (listes d'étapes) : elles deviennent des skills.
- Repère les règles qui ne concernent qu'une partie du projet : elles vont dans
.claude/rules/avecpaths, ou dans un CLAUDE.md de sous-dossier. - Repère tes préférences personnelles : elles vont dans
~/.claude/CLAUDE.md(tous tes projets) ouCLAUDE.local.md(ce projet). - Ce qui reste, vrai pour tout le projet à chaque session, reste dans
CLAUDE.md.
Le prompt pour te faire aider :
Analyse CLAUDE.md et classe chaque section : à garder, à transformer en skill, à déplacer dans .claude/rules/ (avec quel motif paths), ou à déplacer dans CLAUDE.local.md / ~/.claude/CLAUDE.md. Présente-moi un plan de réorganisation, sans rien modifier.
Applique ensuite le plan par petites étapes, en testant dans une nouvelle session après chaque déplacement.
Si ça coince
- Tu ne sais plus où se trouve une règle : tape
/contextpour voir les fichiers chargés, ou demande « Dans quel fichier se trouve la règle sur la durée des vidéos ? ». - La même règle existe à deux endroits : garde-la à l'endroit le plus logique et supprime l'autre.
- Une règle
.claude/rules/ne s'applique jamais : son motifpathsne correspond à aucun fichier ouvert. Corrige le motif.
À retenir
- Du plus général au plus précis : personnel, projet, local, rules, skills.
- Le démarrage charge les fichiers principaux et les descriptions de skills.
- Une règle à un seul endroit, jamais en double.
- Les skills s'appuient sur CLAUDE.md au lieu de le répéter.