Claude Code, Codex et OpenCode chargent tous trois les skills dans le même format : un dossier contenant un fichier SKILL.md. Ce format est le standard ouvert Agent Skills, créé par Anthropic et devenu un projet de la Linux Foundation le 4 novembre 2026. Une même skill peut donc fonctionner dans les trois outils. Le hic, c'est que chaque outil cherche dans des dossiers différents, et que certains champs ne sont compris que par Claude Code. Ce guide montre où cherche chaque outil, comment garder une seule copie que les trois chargent, ce qui ne se transpose pas et comment Orkas donne les mêmes skills à chaque agent de code qu'il exécute.
En bref : gardez le dossier de chaque skill dans ~/.agents/skills. Codex et OpenCode lisent déjà ce dossier. Pas Claude Code : ajoutez donc un lien vers chaque skill dans ~/.claude/skills. Limitez le frontmatter à name et description, et donnez à chaque skill le même nom que son dossier. Vérifié le 8 novembre 2026 avec Claude Code 2.1.319, Codex 0.167.0 et OpenCode 2.2.6.
Où Claude Code, Codex et OpenCode cherchent les skills
| Dossier | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | Non | Oui | Oui |
.agents/skills dans un projet | Non | Oui | Oui |
~/.claude/skills | Oui | Non | Oui |
.claude/skills dans un projet | Oui | Non | Oui |
~/.codex/skills | Non | Oui, mais obsolète | Non |
~/.config/opencode/skills, .opencode/skills | Non | Non | Oui |
| Comment appeler une skill | /skill-name | $skill-name ou /skills | @skill-name |
Les trois choisissent aussi une skill d'eux-mêmes quand votre demande correspond à sa description. Pour les dossiers de projet, chaque outil vérifie le dossier depuis lequel vous le lancez et tous les dossiers parents jusqu'à la racine du dépôt.
- Claude Code est le seul à ne pas trouver
.agents/skills. Sa documentation sur les skills ne mentionne que des dossiers.claude, et sa documentation sur la mémoire indique qu'il ne lit « rien de ce qui se trouve dans un répertoire.agents/». La demande de changement, le ticket #31005, est toujours ouverte, avec plus de 450 votes positifs. - Codex est passé à
.agents/skills. Sa documentation indique.agents/skillsdans le projet,~/.agents/skillspour votre utilisateur et/etc/codex/skillspour les administrateurs. L'ancien dossier~/.codex/skillsest marqué comme obsolète dans le code source, mais il est toujours chargé. Codex ne lit aucun dossier.claude. - OpenCode lit tout. Sa documentation liste ses propres dossiers ainsi que
.claude/skillset.agents/skills, aux deux niveaux. C'est vrai pour la branche 2.2 comme pour la branche 1.19, qui reçoit toujours de nouvelles versions.
Configurer un dossier partagé
Utilisez ~/.agents/skills comme seule copie réelle. Codex et OpenCode le lisent sans aucune configuration, et npx skills comme l'outil d'import de Codex écrivent à cet endroit. Claude Code reçoit ensuite un lien vers chaque skill.
- Déplacez vos skills dans
~/.agents/skills. Pour chaque skill que vous avez écrite dans~/.claude/skillsou~/.codex/skills, déplacez son dossier, par exemplemv ~/.claude/skills/release-notes ~/.agents/skills/. Laissez~/.claude/skills/syncedà sa place : Claude Code y garde les skills de votre compte claude.ai. - Liez chaque skill dans le dossier de Claude Code. Sous macOS ou Linux, lancez ce script. Il ignore toute skill qui a déjà un dossier ou un lien à cet endroit.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
n=$(basename "$d")
[ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done- Sous Windows, utilisez des jonctions. Elles ne nécessitent pas de droits administrateur. Dans PowerShell :
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
$link = "$HOME\.claude\skills\$($_.Name)"
if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}- Vérifiez chaque outil. Ouvrez une nouvelle session. Dans Claude Code, tapez
/et cherchez la skill. Dans Codex, lancez/skills. Dans OpenCode, tapez@.
Pour un projet partagé par l'équipe, faites la même chose dans le dépôt : gardez les skills dans .agents/skills et liez chacune depuis .claude/skills avec un lien relatif, par exemple ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.
Quelques points à soigner :
- Liez chaque skill, pas le dossier entier. Si
~/.claude/skillspointe lui-même vers~/.agents/skills, les dossierssyncedet.trashde Claude Code se retrouvent dans le dossier partagé, et Codex et OpenCode risquent de charger aussi les skills synchronisées. La contrepartie : vous devez relancer la boucle après chaque nouvelle skill. - Liez des dossiers, pas des fichiers SKILL.md. Codex suit un dossier de skill lié, mais il ignore un SKILL.md qui est lui-même un lien. OpenAI a clos cette demande comme non prévue.
- Ne commitez pas de liens si des collègues sont sous Windows. Par défaut, Git for Windows extrait les liens sous forme de petits fichiers texte. Créez les liens avec un script d'installation, ou commitez de vraies copies.
- OpenCode voit chaque skill deux fois et n'en garde qu'une. Il lit à la fois le lien dans
~/.claude/skillset le dossier dans~/.agents/skills. La version 2.2 les fusionne sans rien signaler. La version 1.19 journalise un avertissement de doublon ; définissezOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1pour qu'OpenCode cesse de lire les dossiers de Claude.
Écrire une skill que les trois peuvent charger
Ce SKILL.md se charge de la même façon dans Claude Code, Codex et OpenCode. Il se trouve dans ~/.agents/skills/release-notes/SKILL.md, avec un dossier references et un dossier scripts à côté.
---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---
# Notes de version
1. Trouver le dernier tag : git describe --tags --abbrev=0
2. Lister les commits depuis ce tag : git log <tag>..HEAD --oneline --no-merges
3. Regrouper les commits en Added, Changed et Fixed, d'après references/format.md dans le dossier de cette skill.
4. Pour enregistrer un fichier, exécuter scripts/write_notes.sh depuis le dossier de cette skill.- Donnez à la skill le même nom que son dossier. Utilisez des minuscules, des chiffres et des tirets, jusqu'à 64 caractères. Codex se fie à
name, OpenCode 2.2 au nom du dossier, et Claude Code accepte les deux. Si les deux diffèrent, vous appelez la même skill sous des noms différents selon l'outil. Codex ignore toute skill dont le nom dépasse 64 caractères. - Gardez la description sous les 1 024 caractères et placez en premier les mots que les gens utiliseront. C'est la limite du standard, et Codex tronque à cette longueur les descriptions plus longues dans sa liste de skills.
- Mettez entre guillemets toute valeur qui contient un deux-points suivi d'une espace. Sinon, le frontmatter risque de ne pas être analysé. Codex corrige la plupart de ces cas, Claude Code charge la skill comme si elle n'avait pas de frontmatter, et OpenCode peut ignorer la skill sans afficher d'erreur.
- Faites en sorte que les scripts trouvent leur propre dossier. Les outils exécutent les commandes depuis le dossier de votre projet, pas depuis celui de la skill. Un script qui commence par
cd "$(dirname "$0")"fonctionne depuis n'importe où. - N'utilisez pas "claude" dans le nom si vous risquez d'envoyer la skill sur claude.ai ou vers la Claude API. Les deux refusent les noms qui contiennent "claude" ou "anthropic".
Ce qui ne se transpose pas depuis Claude Code
Codex ne lit que name, description et une description courte sous metadata. OpenCode 2.2 lit aussi metadata et disable-model-invocation. Les deux ignorent tous les autres champs sans erreur : une skill Claude Code se charge donc, mais se comporte différemment.
| Dans une skill Claude Code | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | Fonctionne | Ignoré | Ignoré |
disable-model-invocation: true | Fonctionne | Ignoré ; utiliser agents/openai.yaml | Fonctionne |
context: fork, agent, model, hooks, argument-hint | Fonctionnent | Ignorés | Ignorés |
$ARGUMENTS et $1 dans le texte | Remplacés par vos arguments | Laissés tels quels | Laissés tels quels |
!`command` dans le texte | Exécuté avant que Claude lise la skill | Laissé tel quel | Laissé tel quel |
${CLAUDE_SKILL_DIR} | Remplacé par le dossier de la skill | Laissé tel quel | Laissé tel quel |
- Écrivez des étapes qui fonctionnent sans ces fonctionnalités. Écrivez « exécuter scripts/check.sh depuis le dossier de cette skill » au lieu d'utiliser
${CLAUDE_SKILL_DIR}, et demandez les informations manquantes en langage courant au lieu d'utiliser$ARGUMENTS. Claude Code suit très bien ces mêmes instructions. - Pour empêcher Codex d'appeler une skill de lui-même, ajoutez
agents/openai.yamlau dossier de la skill avecallow_implicit_invocation: falsesouspolicy. Vous pouvez toujours l'appeler avec$skill-name. allowed-toolsne limite pas ce que Codex ou OpenCode peuvent faire. Le tableau de compatibilité denpx skillsl'indique comme pris en charge dans les deux, mais le chargeur de skills d'aucun des deux outils ne lit ce champ. Définissez les limites dans les réglages d'autorisations propres à chaque outil.
Outils qui installent des skills pour plusieurs agents
| Outil | Comment il partage les skills | Points de vigilance |
|---|---|---|
npx skills (Vercel, 38 500 étoiles) | Copie une skill dans .agents/skills et y relie le dossier de chaque agent. Utilise des jonctions sous Windows. --copy crée des copies séparées. | Même organisation que ce guide. Lancez npx skills add owner/repo, avec -g pour votre dossier utilisateur. |
| skillshare (2 900 étoiles) | Garde un seul dossier source et le relie au dossier de chaque outil ; jonctions sous Windows. | Mis à jour le 6 novembre 2026. S'installe avec Homebrew ou un script shell. |
Codex /import | Copie les skills de .claude/skills vers .agents/skills. | Les copies divergent des originaux. Il remplace aussi "claude" par "Codex" dans le texte, y compris dans les chemins de fichiers (ticket ouvert #40147). |
| openskills (10 800 étoiles) | Copie les skills dans .claude/skills et les liste dans AGENTS.md. | Aucune version depuis janvier 2026. Son option --universal écrit dans .agent/skills, qu'aucun des trois outils ne lit. |
Et pour CLAUDE.md et AGENTS.md ?
Codex et OpenCode lisent AGENTS.md, et OpenCode se rabat sur CLAUDE.md quand un projet n'a pas d'AGENTS.md. Depuis la version 2.1.277, Claude Code lit aussi AGENTS.md, mais uniquement dans un projet qui n'a ni CLAUDE.md ni CLAUDE.local.md. Si vous gardez les deux fichiers, ouvrez /config dans Claude Code et réglez Project instructions pour charger les deux. Mettez dans AGENTS.md les règles que tout agent doit suivre, et réservez CLAUDE.md à ce dont seul Claude Code a besoin.
Utiliser les mêmes skills depuis Orkas
Orkas est une application de bureau qui exécute Claude Code, Codex, OpenCode, OpenClaw et Hermes comme agents dans une seule conversation. Elle utilise les versions installées sur votre ordinateur et vos propres connexions. Voici comment vos skills parviennent à ces agents.
- Le dossier partagé continue de fonctionner. Chaque CLI lit toujours ses propres dossiers de skills quand Orkas la lance, donc la configuration ci-dessus fonctionne telle quelle. Orkas ajoute son propre serveur MCP à côté des vôtres au lieu de les remplacer.
- Les skills ajoutées dans Orkas parviennent à chaque CLI. Chaque CLI lancée par Orkas reçoit un serveur MCP nommé
orkas. Ce serveur liste vos skills Orkas, en charge une quand la tâche correspond, et exécute les scripts fournis avec la skill. Demandez à Claude Code d'utiliser une skill par son nom, ou laissez-le trouver la bonne. - Orkas lit aussi vos skills Claude Code et Codex. Les skills de
~/.claude/skillset~/.codex/skillsapparaissent sous Skills ▸ Dossiers globaux, et le Commander peut les utiliser dans ses propres tâches. Orkas se contente de lire ces dossiers et ne les modifie jamais. Il ne lit pas~/.agents/skillsdirectement : avec la configuration ci-dessus, il trouve donc vos skills via les liens de~/.claude/skills.
Pour ajouter un pack de skills depuis GitHub, collez le lien du dépôt dans une conversation avec le Commander et demandez-lui d'installer le pack. Si le pack doit installer des dépendances, Orkas vous le demande d'abord. Les skills apparaissent sous Skills ▸ Paquets externes. Dès lors, Claude Code, Codex et OpenCode peuvent tous les utiliser quand vous les lancez depuis Orkas, sans rien copier dans trois dossiers. Pour commencer, choisissez Connecter des Agents dans la barre latérale et sélectionnez les CLI que vous avez installées. Pour un pas-à-pas complet sur l'utilisation de deux d'entre elles côte à côte, consultez Exécuter Claude Code et Codex ensemble.
Quelle configuration choisir ?
| Votre situation | Que faire |
|---|---|
| Vous utilisez deux ou trois de ces outils sur un même ordinateur | Gardez les skills dans ~/.agents/skills et liez chacune dans ~/.claude/skills |
| Une équipe partage des skills dans un dépôt | Commitez .agents/skills ; créez les liens .claude/skills avec un script d'installation |
| Vous installez souvent des skills depuis GitHub | npx skills add, qui crée ces mêmes liens pour vous |
| Vous n'utilisez que Claude Code et OpenCode | Continuez avec ~/.claude/skills ; OpenCode le lit déjà |
| Vous lancez les CLI depuis Orkas | Installez les packs de skills une fois dans Orkas ; chaque CLI qu'il lance peut les utiliser |
Questions fréquentes
Peut-on utiliser des skills Claude dans Codex ?
Oui. Codex lit le même format SKILL.md, mais il cherche dans ~/.agents/skills et .agents/skills, pas dans ~/.claude/skills. Déplacez-y les dossiers des skills et liez-les en retour pour Claude Code, ou lancez /import dans Codex pour les copier. Des champs comme allowed-tools et des fonctionnalités comme $ARGUMENTS ne fonctionnent que dans Claude Code.
OpenCode lit-il les skills Claude Code ?
Oui. OpenCode lit ~/.claude/skills et .claude/skills ainsi que ~/.agents/skills et ses propres dossiers : les skills Claude Code apparaissent donc sans configuration. Pour désactiver ce comportement, définissez OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.
Claude Code lit-il .agents/skills ?
Non. En novembre 2026, Claude Code ne lit les skills que dans les dossiers .claude, et sa documentation indique qu'il ignore tout ce qui se trouve dans un répertoire .agents. La demande d'ajout, le ticket #31005, est toujours ouverte. En attendant, liez chaque skill depuis ~/.claude/skills.
Pourquoi Codex ne voit-il pas ma skill liée ?
Codex suit un dossier de skill lié, mais il ignore un fichier SKILL.md qui est lui-même un lien. Liez plutôt le dossier entier. Un lien relatif est résolu à partir du dossier où se trouve le lien : vérifiez que le chemin est correct depuis cet endroit.
Pourquoi une skill apparaît-elle deux fois ?
En général, parce que deux copies se trouvent dans des dossiers que l'outil lit. Codex lit encore l'ancien dossier ~/.codex/skills en plus de ~/.agents/skills, et liste les deux copies d'une skill portant le même nom. Gardez une copie dans ~/.agents/skills et supprimez l'autre.
Pour comparer les trois outils au-delà des skills, consultez Claude Code, Codex ou OpenCode.