La réponse courte
- 1Claude Code :
~/.claude/skills/<name>/SKILL.md, ou.claude/skills/dans un projet - 2Codex :
~/.agents/skills/, ou.agents/skills/dans un dépôt ; il lit toujours l’ancien~/.codex/skills/ - 3Cursor :
~/.cursor/skills/ou~/.agents/skills/, plus les dossiers de projet et ceux de Claude Code et Codex
Emplacements des dossiers de Skills pour Claude Code, Codex et Cursor
Chaque agent dispose d’un dossier personnel dans votre répertoire personnel et d’un dossier de projet dans le dépôt. Certains lisent aussi les dossiers d’autres agents : c’est pourquoi une même copie peut apparaître dans plusieurs outils.
| Agent | Personnel | Projet | Lit aussi |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/, plus ceux des sous-dossiers quand Claude y travaille | Paramètres gérés Enterprise, plugins, votre compte claude.ai (synchronisé dans ~/.claude/skills/synced/) |
| Codex | ~/.agents/skills/ | .agents/skills/, du dossier de départ jusqu’à la racine du dépôt | ~/.codex/skills/ (ancien), /etc/codex/skills/, Skills système |
| Cursor | ~/.cursor/skills/, ~/.agents/skills/ | .cursor/skills/, .agents/skills/, n’importe où dans le dépôt | .claude/skills/, .codex/skills/, et les deux dans ~ |
Sous Windows, ~ est votre dossier utilisateur, par exemple C:\Users\you\.claude\skills.
À quoi doit ressembler un dossier de Skills Claude Code
Chaque Skill a son propre dossier, et SKILL.md se trouve directement à l’intérieur. Les fichiers annexes vont dans des sous-dossiers à côté.
~/.claude/skills/
└── launch-page/
├── SKILL.md
├── references/
└── scripts/Le piège du ZIP
La décompression ajoute souvent un niveau, et vous vous retrouvez avec launch-page/launch-page/SKILL.md. Claude Code ne regarde que skills/<name>/SKILL.md : il ne listera donc pas ce Skill. Cursor et Codex cherchent plus en profondeur et peuvent quand même le trouver, ce qui explique les signalements « ça marche dans Cursor, mais pas dans Claude Code ». Remontez le dossier intérieur d’un niveau et tout fonctionne partout.
Quelle copie l’emporte quand deux Skills portent le même nom
Seul Claude Code documente un ordre. Codex peut lister les deux copies, et Cursor ne précise rien.
| Agent | Même nom à deux endroits |
|---|---|
| Claude Code | D’abord Enterprise, puis personnel, puis projet. Les Skills de plugin n’entrent jamais en conflit, car ils portent le nom du plugin. |
| Codex | Ne les fusionne pas ; les deux peuvent apparaître. |
| Cursor | Non documenté pour les Skills. |
Ne comptez pas sur cet ordre. Gardez une seule copie, ou renommez l’une d’elles.
Les Skills dans les Cursor Cloud Agents
Seul ~/.cursor/skills/ est synchronisé avec les Cursor Cloud Agents, et uniquement si Sync Skills for Cloud Agents est activé. Un Skill placé dans ~/.agents/skills/ peut fonctionner sur votre machine et pourtant manquer dans le cloud.
Après avoir déplacé un Skill
La plupart du temps, l’agent s’en aperçoit tout seul. Si le Skill n’apparaît toujours pas, procédez ainsi :
| Agent | Pour voir le changement |
|---|---|
| Claude Code | Rien à faire ; exécutez /reload-skills si le dossier de Skills est nouveau |
| Codex | En général rien ; redémarrez s’il n’apparaît pas |
| Cursor | Ouvrez un nouveau chat ou rechargez la fenêtre |
Questions fréquentes
Où sont stockées les Claude Skills ?
Les Skills personnels vont dans ~/.claude/skills/<name>/SKILL.md. Les Skills de projet vont dans .claude/skills/<name>/SKILL.md à l’intérieur du dépôt.
Où se trouve le dossier de Skills de Codex ?
~/.agents/skills/ pour les Skills personnels et .agents/skills/ dans un dépôt. Codex lit toujours l’ancien ~/.codex/skills/, là où le $skill-installer d’OpenAI place les Skills.
Un seul dossier peut-il servir à tous les agents ?
Non. Cursor les lit tous, mais Claude Code a besoin de ~/.claude/skills/ et Codex de ~/.agents/skills/ ou ~/.codex/skills/.
Sources
Ce guide vous a-t-il aidé ?
