Choisir son agent de code pour utiliser des ressources
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI ou OpenCode : ce que chacun lit (skills, AGENTS.md, rules) et où il cherche ses fichiers.
Mis à jour le
Tous ces agents savent utiliser une ressource PalateKit, mais ils ne cherchent pas leurs fichiers aux mêmes endroits. Cet article résume, pour six agents, ce qu'ils lisent et où. Il ne vous dit pas lequel est le meilleur : le bon choix est surtout celui que vous utilisez déjà.
Trois sortes de fichiers
- Les skills : un dossier avec un fichier
SKILL.md. L'agent le charge quand votre demande y correspond. - Les instructions de projet : un fichier Markdown à la racine du dépôt (
AGENTS.md,CLAUDE.md,GEMINI.md) que l'agent lit à chaque session. - Les rules : des instructions découpées en plusieurs fichiers, parfois réservées à certains types de fichiers.
Les skills sont le format commun : elles passent d'un agent à l'autre. Les instructions et les rules varient davantage d'un outil à l'autre.
Comparatif
| Agent | Skills (projet) | Skills (personnelles) | Instructions et rules |
|---|---|---|---|
| Claude Code | .claude/skills/ | ~/.claude/skills/ | CLAUDE.md, .claude/rules/, AGENTS.md en l'absence de CLAUDE.md |
| Codex | .agents/skills/ | ~/.agents/skills/ | AGENTS.md (et AGENTS.override.md) |
| Cursor | .agents/skills/, .cursor/skills/ | ~/.agents/skills/, ~/.cursor/skills/ | .cursor/rules/ (fichiers .mdc), AGENTS.md |
| GitHub Copilot | .github/skills/, .claude/skills/, .agents/skills/ | ~/.copilot/skills/, ~/.agents/skills/ | .github/copilot-instructions.md, .github/instructions/, AGENTS.md |
| Gemini CLI | .gemini/skills/, .agents/skills/ | ~/.gemini/skills/, ~/.agents/skills/ | GEMINI.md |
| OpenCode | .opencode/skills/, .claude/skills/, .agents/skills/ | ~/.config/opencode/skills/, ~/.claude/skills/, ~/.agents/skills/ | AGENTS.md, CLAUDE.md en repli |
Le dossier .agents/skills/ est lu par cinq de ces six agents. Claude Code est le seul à ne lire que .claude/skills/ ; copiez-y la ressource si vous l'utilisez.
Les agents un par un
Claude Code
Les skills vont dans .claude/skills/<nom>/SKILL.md (projet) ou ~/.claude/skills/<nom>/SKILL.md (toutes vos sessions). Pour les instructions, il lit CLAUDE.md, des fichiers .claude/rules/ qui peuvent être limités à certains chemins, et AGENTS.md quand aucun CLAUDE.md n'existe. Voir la page Claude Code.
Codex
Il parcourt .agents/skills/ depuis le dossier de travail jusqu'à la racine du dépôt, puis ~/.agents/skills/. Chaque skill doit déclarer un name et une description. Pour les instructions, il assemble les AGENTS.md de la racine du projet jusqu'au dossier courant ; AGENTS.override.md passe avant AGENTS.md dans un même dossier. Voir la page Codex.
Cursor
Il charge .agents/skills/ et .cursor/skills/, et par compatibilité .claude/skills/ et .codex/skills/. Ses rules vivent dans .cursor/rules/ ; le fichier doit avoir l'extension .mdc, un simple .md y est ignoré. Il lit aussi AGENTS.md. Voir la page Cursor.
GitHub Copilot
Les skills fonctionnent dans la CLI de Copilot, l'agent cloud, la revue de code et le mode agent de VS Code, Visual Studio et des IDE JetBrains (selon la version). Les instructions du dépôt tiennent dans .github/copilot-instructions.md, dans des fichiers .github/instructions/*.instructions.md limités par un motif applyTo, ou dans AGENTS.md. Voir la page GitHub Copilot.
Gemini CLI
Il lit .gemini/skills/ et l'alias .agents/skills/, côté projet comme côté utilisateur ; à nom égal, .agents/skills/ l'emporte. Son fichier d'instructions est GEMINI.md. Pour qu'il lise AGENTS.md, ajoutez ce nom à context.fileName dans settings.json. Voir la page Gemini CLI.
OpenCode
Il cherche dans .opencode/skills/, .claude/skills/ et .agents/skills/, du dossier courant jusqu'à la racine du dépôt, puis dans les équivalents de votre dossier personnel. Il lit AGENTS.md, et CLAUDE.md seulement si AGENTS.md n'existe pas. Voir la page OpenCode.
Comment choisir
- Vous avez déjà un agent : gardez-le et installez les ressources dans son dossier.
- Vous en utilisez plusieurs : mettez vos skills dans
.agents/skills/, que la plupart lisent, et ajoutez.claude/skills/pour Claude Code. - Vous partagez un dépôt avec une équipe : commitez les skills du projet et un
AGENTS.md, que presque tous les agents lisent.
Installer
La commande npx --yes palatekit@latest install <slug> copie la ressource dans le dossier de l'agent indiqué ; le prompt d'installation et le ZIP donnent le même résultat. La page de chaque agent liste ses dossiers. Pour un premier essai, suivez Installer votre première ressource, puis parcourez les skills ou les rules.
Sources
Questions fréquentes
Une même skill fonctionne-t-elle dans plusieurs agents ?
Oui. Une skill est un dossier avec un fichier SKILL.md. Codex, Cursor, GitHub Copilot, Gemini CLI et OpenCode lisent le dossier .agents/skills, et plusieurs d'entre eux lisent aussi .claude/skills. Claude Code lit .claude/skills.
Quel agent choisir pour débuter ?
Celui que vous utilisez déjà. Les ressources se copient dans le dossier de votre agent ; changer d'agent plus tard ne vous oblige pas à tout refaire.
Qu'est-ce qu'AGENTS.md ?
Un fichier Markdown d'instructions placé dans le projet. Codex, Cursor, GitHub Copilot et OpenCode le lisent ; Claude Code le lit s'il n'y a pas de CLAUDE.md ; Gemini CLI le lit si vous le déclarez dans ses réglages.