Où chaque agent cherche ses skills et ses instructions
Les dossiers de skills (utilisateur et projet) et les fichiers d'instructions de Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI et OpenCode, d'après leur documentation officielle.
Mis à jour le
Chaque agent de code cherche ses skills dans des dossiers précis, et ses instructions permanentes dans des fichiers à part. Cette page les réunit, d'après la documentation officielle de chaque éditeur. Si une skill ne se charge pas, c'est presque toujours qu'elle est au mauvais endroit.
Chaque skill est un dossier qui contient un fichier SKILL.md. Le chemin complet est donc le dossier ci-dessous, puis le nom de la skill, puis SKILL.md. Pour le contenu du fichier, voir le format d'une skill.
Dossiers de skills
Le niveau « utilisateur » s'applique à tous vos projets sur la machine. Le niveau « projet » vaut pour le dépôt courant et se partage avec l'équipe par Git.
| Agent | Utilisateur | Projet |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
| Cursor | ~/.agents/skills/, ~/.cursor/skills/ | .agents/skills/, .cursor/skills/ |
| GitHub Copilot | ~/.copilot/skills/, ~/.agents/skills/ | .github/skills/, .claude/skills/, .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/, ~/.agents/skills/ | .gemini/skills/, .agents/skills/ |
| OpenCode | ~/.config/opencode/skills/, ~/.claude/skills/, ~/.agents/skills/ | .opencode/skills/, .claude/skills/, .agents/skills/ |
Dossiers lus en plus
Plusieurs agents lisent aussi les dossiers d'un autre agent, ce qui évite de dupliquer vos skills.
- Cursor charge en plus
.claude/skills/et.codex/skills/dans le projet,~/.claude/skills/et~/.codex/skills/côté utilisateur. - OpenCode et GitHub Copilot lisent
.claude/skills/dans le projet. - Gemini CLI donne la priorité à
.agents/skills/sur.gemini/skills/quand une même skill existe dans les deux.
Ce qui change d'un agent à l'autre
- Claude Code charge aussi les skills des dossiers
.claude/skills/situés dans les répertoires parents jusqu'à la racine du dépôt. Celles d'un sous-dossier se chargent la première fois que Claude lit ou modifie un fichier de ce sous-dossier. En cas de doublon de nom, la skill d'entreprise passe avant la personnelle, qui passe avant celle du projet. - Codex parcourt
.agents/skills/depuis le dossier de lancement jusqu'à la racine du dépôt. Un emplacement d'administrateur existe aussi :/etc/codex/skills. - Cursor découvre aussi les dossiers
.cursor/skills/et.agents/skills/des sous-dossiers du dépôt, et limite ces skills aux fichiers de ce sous-dossier. - Gemini CLI : la skill du projet l'emporte sur celle de l'utilisateur quand les noms sont identiques.
Fichiers d'instructions
Ces fichiers ne sont pas des skills : l'agent les lit à chaque session.
| Agent | Utilisateur | Projet |
|---|---|---|
| Claude Code | ~/.claude/CLAUDE.md | ./CLAUDE.md ou ./.claude/CLAUDE.md, et ./CLAUDE.local.md pour vos préférences privées |
| Codex | ~/.codex/AGENTS.md (ou AGENTS.override.md), dossier modifiable par CODEX_HOME | AGENTS.md (ou AGENTS.override.md), de la racine du projet jusqu'au dossier courant |
| Cursor | Réglage Customize › Rules, hors des fichiers | .cursor/rules, ou AGENTS.md à la racine |
| GitHub Copilot | Non documenté ici | .github/copilot-instructions.md, .github/instructions/, AGENTS.md |
| Gemini CLI | ~/.gemini/GEMINI.md | GEMINI.md dans l'espace de travail et ses dossiers parents |
| OpenCode | ~/.config/opencode/AGENTS.md, à défaut ~/.claude/CLAUDE.md | AGENTS.md à la racine, à défaut CLAUDE.md |
Les autres agents
Les agents du catalogue qui ne figurent pas ci-dessus (Kiro, Cline, Windsurf, Amp, Goose et d'autres) ont leur propre dossier. Il est indiqué sur la page de chaque agent, par exemple Kiro ou Cline. Vérifiez-le toujours dans la documentation de l'éditeur : ces emplacements évoluent.
Installer au bon endroit
La commande npx --yes palatekit@latest install copie une ressource dans le dossier choisi ; avec l'option --agent, elle vise le dossier de l'agent indiqué. Les ressources sont décrites dans le catalogue de skills, et la page d'installation détaille les trois méthodes.
Sources
Questions fréquentes
Un même dossier peut-il servir à plusieurs agents ?
Oui : le dossier .agents/skills/ est lu par Codex, Cursor, GitHub Copilot, Gemini CLI et OpenCode, au niveau du projet comme au niveau utilisateur. Claude Code, lui, lit .claude/skills/, que Cursor, GitHub Copilot et OpenCode lisent aussi.
Où mettre une skill pour qu'elle s'applique à tous mes projets ?
Dans le dossier utilisateur de votre agent, par exemple ~/.claude/skills/ pour Claude Code ou ~/.agents/skills/ pour Codex. Un dossier de projet ne vaut que pour ce dépôt.
Quelle est la différence entre une skill et un fichier d'instructions ?
Un fichier d'instructions (CLAUDE.md, AGENTS.md, GEMINI.md) est lu à chaque session. Une skill est un dossier que l'agent charge quand votre demande y correspond.