Codex vs Claude Code Skills : Configuration, Paramètres et Comment Partager des Skills entre les Deux

Name

Soren Atelier

Updated on 10/02/2026

Les "skills" deviennent rapidement l'unité portable de réutilisation pour les agents de codage IA. Un skill est un dossier qui regroupe des instructions, des scripts optionnels et des fichiers de référence en un ensemble qu'un agent peut découvrir et appliquer de manière fiable. Si vous travaillez avec plus d'un outil de codage IA, vous avez probablement déjà ressenti la friction liée au maintien de configurations séparées pour chacun.

OpenAI Codex et Anthropic Claude Code prennent tous deux en charge les skills et s'appuient sur le standard ouvert Agent Skills. Codex indique explicitement que ses skills reposent sur ce standard et utilisent la "divulgation progressive" pour gérer efficacement le contexte. Claude Code suit également le standard Agent Skills tout en ajoutant ses propres extensions comme les contrôles d'invocation, les sous-agents et l'injection dynamique de contexte.

Cette base commune est ce qui rend possible un workflow "écrire une fois, utiliser dans les deux outils" — à condition de faire attention à où les skills sont stockés, comment les paramètres diffèrent et quels champs de frontmatter sont portables. Ce guide détaille chaque différence pratique et vous montre comment partager un seul skill entre les deux agents.

Comparaison Rapide : Skills Codex vs Skills Claude Code

Modèle Mental : Même SKILL.md, Écosystèmes Différents

Les deux outils partagent le concept de base : un répertoire contenant un fichier SKILL.md avec un frontmatter YAML (name, description) et des instructions en Markdown. L'agent lit les métadonnées pour décider quand utiliser le skill et charge les instructions complètes lorsqu'il l'active. Les différences résident dans les chemins de découverte, les formats de configuration et les fonctionnalités avancées.

Ce que Codex Entend par "Skills"

Les skills Codex sont des répertoires contenant un SKILL.md requis et des dossiers optionnels scripts/, references/, assets/, ainsi qu'un fichier optionnel agents/openai.yaml pour les métadonnées d'interface et les dépendances (comme les serveurs MCP).

Codex charge d'abord les métadonnées du skill et ne charge les instructions complètes que s'il décide d'utiliser le skill. C'est ce qu'on appelle la divulgation progressive — cela permet de garder les fenêtres de contexte légères en n'injectant que ce dont l'agent a réellement besoin.

Ce que Claude Code Entend par "Skills"

Les skills Claude Code sont également basés sur SKILL.md et fonctionnent comme des commandes slash réutilisables. Claude peut les invoquer automatiquement lorsqu'ils sont pertinents, ou vous pouvez les exécuter directement via /skill-name.

Claude Code a explicitement fusionné les commandes slash personnalisées avec les skills :

• .claude/commands/review.md et .claude/skills/review/SKILL.md créent tous deux /review
• Les skills ajoutent des fichiers de support, le contrôle d'invocation et le chargement automatique en fonction de la pertinence

Comment Créer et Installer un Skill dans Codex

1. Structure du Répertoire du Skill

Au minimum, un skill Codex nécessite :

my-skill/
  SKILL.md

Un skill complet peut inclure :

my-skill/
  SKILL.md
  scripts/
    run-check.sh
  references/
    CHECKLIST.md
  assets/
    diagram.png
  agents/
    openai.yaml

Le SKILL.md doit inclure name et description dans son frontmatter YAML.

2. Où Codex Découvre les Skills

Codex parcourt plusieurs emplacements avec un ordre de priorité défini :

Codex prend également en charge explicitement les dossiers de skills via symlink et suit la cible du symlink lors du parcours.

3. Utiliser les Outils de Skills Intégrés

Codex fournit deux assistants intégrés :

• $skill-creator — génère un nouveau répertoire de skill avec la structure correcte
• $skill-installer — récupère et installe des skills depuis des sources externes

4. Activer ou Désactiver des Skills dans les Paramètres

Codex peut désactiver un skill sans le supprimer en ajoutant des entrées sous [[skills.config]] dans la configuration TOML :

# ~/.codex/config.toml
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Redémarrez Codex après avoir modifié la configuration.

5. Format des Paramètres Codex

La configuration Codex se fait dans des fichiers TOML avec un ordre de priorité clair :

Options CLI > profils > config projet (.codex/config.toml) > config utilisateur (~/.codex/config.toml) > config système > valeurs par défaut

Les skills peuvent être contrôlés via ces paramètres, et ces paramètres peuvent être limités à un projet spécifique.

Comment Créer et Installer un Skill dans Claude Code

1. Structure du Répertoire du Skill

Les skills Claude Code sont des répertoires avec SKILL.md comme point d'entrée. Les fichiers supplémentaires sont optionnels :

my-skill/
  SKILL.md
  template.md
  examples/
    sample.md
  scripts/
    validate.sh

Référencez les fichiers de support depuis votre SKILL.md pour que Claude sache ce qu'ils contiennent et quand les charger.

2. Où Claude Code Découvre les Skills

Claude Code dispose de plusieurs portées avec un ordre de priorité :

Claude Code prend également en charge la découverte imbriquée dans les monorepos : si vous modifiez packages/frontend/..., il cherche aussi dans packages/frontend/.claude/skills/.

3. Le Format SKILL.md : YAML + Markdown

Les skills Claude Code comportent deux parties — le frontmatter YAML et les instructions Markdown :

---
name: explain-code
description: Explains code with visual diagrams and analogies.
---
 
When explaining code:
1) Start with an analogy
2) Draw an ASCII diagram
3) Walk step-by-step
4) Highlight a gotcha

Le name devient la /commande-slash, et la description aide Claude à décider quand le charger automatiquement.

4. Fonctionnalités Étendues des Skills Claude Code

Claude Code étend le standard avec des fonctionnalités non disponibles dans Codex :

C'est la plus grande différence pratique : les skills Claude Code peuvent se comporter comme des mini-workflows avec prétraitement et sous-agents, tandis que les skills Codex mettent l'accent sur l'empaquetage des instructions, ressources et scripts avec chargement progressif.

5. Format des Paramètres Claude Code

Les paramètres Claude Code sont en JSON, organisés par portée (géré/utilisateur/projet/local), et modifiables via /config dans le REPL interactif :

• Utilisateur : ~/.claude/settings.json
• Projet : .claude/settings.json
• Surcharges locales : .claude/settings.local.json

Différences Clés : Comparaison Détaillée

Chemins de Découverte

Codex :       .agents/skills/  →  $HOME/.agents/skills/  →  /etc/codex/skills/
Claude Code : .claude/skills/  →  ~/.claude/skills/       →  enterprise managed

C'est la raison principale pour laquelle le partage de skills nécessite des symlinks ou un dépôt partagé.

Formats des Paramètres

UX d'Activation

• Codex : liste /skills et mention $ dans CLI/IDE ; sélection implicite via description
• Claude Code : invocation /skill-name ; chargement automatique basé sur description

Extensions Spécifiques aux Outils

• Codex : fichier optionnel agents/openai.yaml pour les métadonnées d'interface et la déclaration de dépendances (ex. : serveurs MCP)
• Claude Code : champs de frontmatter comme disable-model-invocation, context: fork, prétraitement de commandes (!`…`), passage d'arguments

Le Noyau Commun : Standard Ouvert Agent Skills

Si vous souhaitez qu'un skill fonctionne à la fois dans Codex et Claude Code, ancrez-le dans la spécification Agent Skills. Voici ce que le standard exige :

Champs de Frontmatter Requis

Codex exige les deux champs. Claude Code est plus permissif (il peut utiliser le nom du répertoire par défaut), mais pour une réutilisation multi-agents, considérez les deux comme requis.

Références aux Fichiers

Le standard recommande de référencer les fichiers en utilisant des chemins relatifs depuis la racine du skill :

See [the reference guide](references/REFERENCE.md) for details.
 
Run the extraction script:
scripts/extract.py

Gardez les références à un seul niveau de profondeur pour éviter les chaînes imbriquées complexes.

Comment Partager un Skill entre les Deux Agents avec des Symlinks

Le modèle le plus propre pour utiliser un skill dans les deux outils :

1. Maintenir un dépôt ou dossier canonique unique pour les skills
2. Créer des symlinks de ces dossiers de skills vers le chemin de découverte de chaque agent

Configuration Étape par Étape

Supposons que vous conservez vos skills partagés dans ~/shared-agent-skills/ :

~/shared-agent-skills/
  code-review/
    SKILL.md
    references/
      REVIEW_CHECKLIST.md
  test-writer/
    SKILL.md
    scripts/
      run-tests.sh

Lier dans un projet pour Codex :

mkdir -p .agents/skills
ln -s ~/shared-agent-skills/code-review .agents/skills/code-review
ln -s ~/shared-agent-skills/test-writer .agents/skills/test-writer

Lier dans le même projet pour Claude Code :

mkdir -p .claude/skills
ln -s ~/shared-agent-skills/code-review .claude/skills/code-review
ln -s ~/shared-agent-skills/test-writer .claude/skills/test-writer

Ou lier au niveau utilisateur pour tous les projets :

# Codex (portée utilisateur)
ln -s ~/shared-agent-skills/code-review $HOME/.agents/skills/code-review
 
# Claude Code (portée utilisateur)
ln -s ~/shared-agent-skills/code-review ~/.claude/skills/code-review

Notes de Compatibilité des Symlinks

Si le listing /skills de Claude Code n'affiche pas votre skill lié par symlink, vous pouvez toujours l'invoquer directement par son nom.

Un Modèle de SKILL.md Portable

Voici un modèle conforme au standard qui fonctionne dans les deux agents :

---
name: code-review
description: >
  Perform a structured code review for correctness, security,
  performance, and readability. Use when asked to review a
  diff, PR, or when preparing changes for merge.
license: MIT
compatibility: >
  Intended for coding agents (Codex, Claude Code) in Git repos.
  Requires read access to the repo.
metadata:
  owner: platform-team
  version: "1.0.0"
---
 
# Code Review Skill
 
## Inputs
- A diff, PR link, or list of changed files.
- The relevant module/service context.
 
## Process
1. Identify the goal of the change and expected behavior.
2. Review for correctness (edge cases, error handling).
3. Review for security (authz/authn, injection risks, secrets).
4. Review for performance (N+1 queries, hot paths, allocations).
5. Review for maintainability (naming, structure, tests).
6. Summarize findings with:
   - Must-fix items
   - Suggestions
   - Positive notes
 
## Reference checklist
See [our checklist](references/REVIEW_CHECKLIST.md) for the full list.

Ajout de Métadonnées Spécifiques à Codex (Optionnel)

Ajoutez agents/openai.yaml pour les métadonnées d'interface et les dépendances Codex. Les autres outils l'ignoreront :

# agents/openai.yaml
display_name: "Code Review"
icon: "🔍"
dependencies:
  mcp_servers:
    - github

Ajout de Fonctionnalités Spécifiques à Claude Code (Optionnel)

Pour les workflows réservés à Claude, vous pouvez ajouter un frontmatter étendu dans un skill spécifique à Claude ou dans une surcharge .claude/ :

---
name: code-review
description: Structured code review with security focus.
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash(git diff*)
context: fork
---

Bonnes Pratiques pour les Skills Multi-Agents

1. Conserver le Contenu Portable dans le Dossier Partagé

Limitez-vous aux champs du standard Agent Skills (name, description) et utilisez references/ avec des liens relatifs pour les documents longs et les checklists. Cela garantit que les deux agents peuvent analyser et utiliser le skill.

2. Isoler les Fonctionnalités Avancées Spécifiques aux Outils

• Pour Claude Code : context: fork, le prétraitement de commandes ! et allowed-tools sont puissants mais spécifiques à Claude
• Pour Codex : agents/openai.yaml est spécifique à Codex mais proprement séparé dans son propre fichier

Aucun des deux outils ne plante sur des champs inconnus — ils les ignorent simplement. Mais par souci de clarté, il est préférable de garder les fonctionnalités spécifiques aux outils dans des fichiers ou surcharges dédiés.

3. Utiliser un Dépôt Git Partagé pour les Skills

shared-agent-skills/          # Dépôt Git
├── code-review/
│   ├── SKILL.md
│   └── references/
├── test-writer/
│   ├── SKILL.md
│   └── scripts/
├── setup-links.sh            # Script d'installation des symlinks
└── README.md

Un simple setup-links.sh peut automatiser la création des symlinks :

#!/bin/bash
SKILL_DIR="$(cd "$(dirname "$0")" && pwd)"
 
# Lier dans la portée utilisateur Codex
mkdir -p "$HOME/.agents/skills"
for skill in "$SKILL_DIR"/*/; do
  name=$(basename "$skill")
  [ "$name" = "scripts" ] && continue
  ln -sfn "$skill" "$HOME/.agents/skills/$name"
done
 
# Lier dans la portée utilisateur Claude Code
mkdir -p "$HOME/.claude/skills"
for skill in "$SKILL_DIR"/*/; do
  name=$(basename "$skill")
  [ "$name" = "scripts" ] && continue
  ln -sfn "$skill" "$HOME/.claude/skills/$name"
done
 
echo "Skills liés pour Codex et Claude Code."

4. Versionner Vos Skills

Incluez un champ version dans les métadonnées et taguez les releases dans votre dépôt de skills partagés. Quand un skill change de comportement, incrémenter la version aide les équipes à suivre ce qui a changé et quand.

Si vous utilisez des agents de codage IA comme Codex ou Claude Code pour des workflows d'analyse de données, des outils comme PyGWalker (opens in a new tab) peuvent transformer vos DataFrames en visualisations interactives — et vous pouvez créer un skill qui intègre PyGWalker dans la boîte à outils de votre agent pour l'exploration de données à la demande.

FAQ

Qu'est-ce que le standard ouvert Agent Skills ?

Le standard ouvert Agent Skills est une spécification qui définit comment les agents de codage IA découvrent et utilisent des packages de skills réutilisables. Il établit un format commun — un répertoire avec un fichier SKILL.md contenant un frontmatter YAML et des instructions Markdown — afin que les skills soient portables entre différents outils d'agents.

Puis-je utiliser le même SKILL.md dans Codex et Claude Code ?

Oui. Les deux agents s'appuient sur le standard Agent Skills et reconnaissent les fichiers SKILL.md avec un frontmatter name et description. L'exigence principale est de placer le skill dans le chemin de découverte de chaque agent (.agents/skills/ pour Codex, .claude/skills/ pour Claude Code), ce que vous pouvez faire avec des symlinks depuis un emplacement canonique unique.

Quelles sont les principales différences entre les skills Codex et les skills Claude Code ?

Les différences principales sont les chemins de découverte (.agents/skills/ vs .claude/skills/), les formats de paramètres (TOML vs JSON) et les fonctionnalités d'extension. Claude Code ajoute le forking de contexte en sous-agent, le prétraitement de commandes shell et les contrôles d'accès aux outils. Codex ajoute agents/openai.yaml pour les métadonnées d'interface et les dépendances de serveurs MCP. Le format de base SKILL.md est compatible entre les deux.

Les symlinks fonctionnent-ils pour partager des skills entre agents ?

Codex prend explicitement en charge les dossiers de skills via symlink et suit les cibles. Claude Code fonctionne également avec les symlinks pour l'invocation, bien que la commande de listing /skills puisse ne pas détecter les skills liés par symlink dans certaines versions. Vous pouvez toujours invoquer les skills liés par symlink par leur nom même s'ils n'apparaissent pas dans la liste.

Quels champs de frontmatter sont requis pour les skills portables ?

La spécification Agent Skills exige name (doit correspondre au répertoire parent, en minuscules avec des tirets, 1-64 caractères) et description (aide les agents à décider quand utiliser le skill). Codex et Claude Code prennent tous deux en charge ces champs. Des champs supplémentaires comme license, compatibility et metadata sont optionnels mais recommandés.

Où dois-je placer les skills pour un accès à l'échelle de l'utilisateur ?

Pour Codex, placez les skills dans $HOME/.agents/skills/. Pour Claude Code, utilisez ~/.claude/skills/. Les deux emplacements rendent les skills disponibles pour tous les projets sans nécessiter de configuration par dépôt.

Conclusion

Les skills Codex et Claude Code partagent plus d'ADN que leurs écosystèmes différents ne le suggèrent. Tous deux s'appuient sur le standard ouvert Agent Skills, tous deux utilisent SKILL.md comme point d'entrée, et tous deux supportent le chargement progressif basé sur les descriptions de skills. Les différences pratiques — chemins de découverte, formats de configuration et fonctionnalités d'extension — sont réelles mais gérables.

La meilleure stratégie consiste à maintenir une source unique de vérité pour vos skills, à s'en tenir aux champs name et description requis par le standard pour le noyau portable, et à utiliser des symlinks pour que chaque agent voie le même dossier de skill. Conservez les fonctionnalités avancées spécifiques aux outils (le forking en sous-agent de Claude, les métadonnées YAML de Codex) dans leurs fichiers d'extension respectifs. De cette manière, vous obtenez la portabilité sans sacrifier les capacités avancées de l'un ou l'autre outil.