La réponse courte
CLAUDE.md, AGENTS.md et les règles Cursor restent dans le contexte à chaque session : limitez-les donc à des faits et des limites. Un Skill ne se charge que lorsque sa tâche se présente, ce qui lui permet de contenir une longue procédure sans alourdir chaque chat.
Qui lit CLAUDE.md, AGENTS.md et les règles Cursor
Claude Code lit CLAUDE.md, Codex lit AGENTS.md, et Cursor lit ses propres règles ainsi que ces deux fichiers. Tous trois lisent SKILL.md, mais seulement quand c’est nécessaire.
| Fichier | Lu par | Quand |
|---|---|---|
CLAUDE.md | Claude Code, Cursor | Claude Code : au démarrage de la session, depuis ~/.claude/CLAUDE.md et le projet ; le fichier d’un sous-dossier dès que Claude travaille dans ce dossier. Cursor : toujours appliqué. |
AGENTS.md | Codex, Cursor | Codex : ~/.codex/AGENTS.md d’abord, puis un fichier par dossier, de la racine du dépôt jusqu’au dossier de départ ; le plus proche l’emporte ; 32 Kio au total. Cursor : toujours appliqué. |
.cursor/rules/*.mdc | Cursor | L’un des quatre modes : Always Apply, Apply Intelligently, Apply to Specific Files ou Apply Manually |
SKILL.md | Les trois | Uniquement quand une demande lui correspond, ou que vous l’appelez par son nom |
Ce qui va dans CLAUDE.md et ce qui va dans un Skill
Une bonne règle empirique : si cela tient en une ligne et doit s’appliquer dans chaque chat, c’est une instruction. S’il faut une page pour l’expliquer et que cela ne concerne qu’un type de tâche, c’est un Skill.
| Vous voulez dire | À mettre dans |
|---|---|
| « Utilise pnpm, pas npm. » | Fichier d’instructions |
| « Ne déploie jamais sans approbation. » | Fichier d’instructions |
| « Lance les tests avant de commiter. » | Fichier d’instructions |
| « Comment nous rédigeons une note de version, étape par étape. » | Un Skill |
| « Construis une présentation de lancement dans notre style de marque. » | Un Skill |
À chaque session
Les fichiers d’instructions consomment du contexte dans chaque chat, que vous les utilisiez ou non
Au besoin
Un Skill coûte environ une phrase tant qu’il n’est pas utilisé
Comment sortir une procédure de CLAUDE.md
Un avant/après classique
Un CLAUDE.md se voit peu à peu doté d’une section de 60 lignes sur la rédaction des notes de version. Chaque chat en paie le prix, y compris les sessions de débogage. Déplacez-la dans un Skill : il ne reste qu’une ligne, et la procédure ne se charge que lorsque vous demandez des notes de version.
- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.- 1
Coupez la procédure et collez-la dans
.claude/skills/release-notes/SKILL.md(ou.agents/skills/pour Codex et Cursor). - 2
Rédigez une description qui dit quand l’utiliser.
- 3
Laissez un renvoi d’une ligne dans le fichier d’instructions.
Vous devriez voir : un fichier d’instructions plus court, et une procédure qui ne se charge que lorsque vous demandez des notes de version.
Dans Cursor, /migrate-to-skills convertit pour vous les règles « Apply Intelligently » en Skills.
Questions fréquentes
Qu’est-ce que CLAUDE.md ?
Un fichier Markdown d’instructions que Claude Code lit au début de chaque session. Le vôtre se trouve dans ~/.claude/CLAUDE.md ; celui d’un projet se trouve dans CLAUDE.md ou .claude/CLAUDE.md.
Faut-il utiliser AGENTS.md ou des Skills dans Codex ?
Les deux. Mettez les règles courtes toujours valables dans AGENTS.md, et les procédures qui ne doivent se charger qu’au besoin dans des Skills. Le guide Codex couvre les deux.
Les règles Cursor sont-elles la même chose que les Skills ?
Non. Les règles sont des fichiers .mdc ajoutés aux conversations ; les Skills sont des dossiers que l’agent utilise quand ils sont pertinents ou quand vous les appelez. Voir le guide Cursor.
Sources
Ce guide vous a-t-il aidé ?
