Skills Codex : installer, utiliser et les meilleurs choix

Un skill Codex est un dossier contenant un fichier SKILL.md qui apprend à l'agent Codex d'OpenAI comment faire une tâche précise — rédiger une PR, lancer votre suite de tests, suivre la checklist de revue de votre équipe. Codex lit le nom et la description de chaque skill, puis ne charge les instructions complètes que quand la tâche l'exige. Si vous avez cherché « skills Codex », voici ce que c'est, comment en installer un, comment Codex décide de l'utiliser, et où en trouver de bons.

Ce qu'est un skill (et sa différence avec un prompt)

Un skill est un dossier ancré par un manifeste SKILL.md obligatoire — un fichier Markdown avec un frontmatter YAML (au minimum un name et une description) suivi d'instructions pas à pas. À côté du SKILL.md, un skill peut embarquer des scripts, des fichiers de référence et des ressources optionnels.

C'est un cran au-dessus des anciens custom prompts. Un prompt était un fichier unique que vous déclenchiez à la main. Un skill est découvrable : Codex indexe les métadonnées de chaque skill qu'il trouve et peut choisir le bon tout seul. OpenAI oriente désormais les nouveaux workflows réutilisables vers les skills plutôt que les prompts. Les skills suivent aussi le format ouvert SKILL.md commun à l'écosystème des agents : un skill bien écrit est portable.

Où vivent les skills

Codex cherche les skills à plusieurs endroits, par ordre de priorité :

Projet — .agents/skills/ dans un dépôt. Committez-les pour que toute l'équipe en profite.
Utilisateur — ~/.agents/skills/ (soit $HOME/.agents/skills/). Vos skills personnels, disponibles dans chaque projet.
Système / intégrés — les skills livrés avec Codex.

Quand deux skills portent le même nom, celui du projet l'emporte sur celui de l'utilisateur, qui l'emporte sur les défauts système. Un dépôt peut ainsi surcharger un skill personnel avec ses propres conventions.

Installer un skill

Un skill n'est qu'un dossier : l'installer, c'est copier ce dossier dans un répertoire de skills. Pour ajouter un skill personnel :

mkdir -p ~/.agents/skills/revue-pr

Créez ~/.agents/skills/revue-pr/SKILL.md :

---
name: revue-pr
description: Relire le diff d'une pull request : bugs, failles de sécurité et tests manquants
---

Pour relire une PR :
- Résumer ce que change le diff en deux phrases.
- Signaler d'abord bugs et failles, avec fichier et ligne.
- Noter toute fonction publique dont le comportement change sans test.
- Regrouper les remarques de style dans une courte liste à part.

Codex détecte les nouveaux skills automatiquement ; si le nouveau n'apparaît pas, redémarrez Codex. Pour le partager avec l'équipe, placez le même dossier sous .agents/skills/ dans le dépôt et committez-le.

Utiliser un skill

Codex propose trois façons de déclencher un skill :

Automatique. Décrivez votre tâche normalement. Si elle correspond à la description d'un skill, Codex l'exécute de lui-même. C'est tout l'intérêt de l'approche « métadonnées d'abord ».
Explicite. Appelez le skill par son nom, préfixé de $, dans votre prompt — par exemple $revue-pr sur cette branche. À utiliser quand vous voulez un skill précis à coup sûr.
Parcourir. Listez les skills disponibles avec la commande /skills et choisissez.

Comme Codex ne lit que les noms et descriptions jusqu'à l'invocation, une description nette et spécifique est la ligne la plus importante de votre SKILL.md : c'est elle qui rend le skill découvrable au bon moment.

Écrire un skill que Codex va vraiment chercher

Faites de la description un déclencheur, pas un titre. « Relire un diff de PR : bugs et tests manquants » vaut mieux que « Aide à la revue ». Codex matche dessus.
Gardez le corps prescriptif. Des étapes concrètes et un format de sortie, pas des encouragements vagues.
Poussez le détail dans des fichiers. Longues checklists ou scripts vont dans des fichiers voisins référencés par le skill, pour garder le manifeste lisible.
Un skill, une tâche. Un skill qui veut tout faire est dur à matcher et dur à suivre.

Skills vs AGENTS.md

Codex a une seconde façon de porter des instructions : AGENTS.md. Il fonctionne en hiérarchie — un ~/.codex/AGENTS.md global, un AGENTS.md à la racine du dépôt, et d'éventuels autres dans des sous-dossiers — et son contenu est un contexte toujours actif pour ce périmètre. Un skill, c'est l'inverse : cadré, chargé seulement quand sa description correspond ou quand vous l'appelez. Utilisez AGENTS.md pour les conventions permanentes qui s'appliquent à tout (« ce dépôt utilise pnpm, TypeScript strict, Conventional Commits »), et les skills pour des workflows nommés déclenchés à la demande. Ils se complètent : garde-fous larges dans AGENTS.md, playbooks précis dans ~/.agents/skills/.

Les meilleurs skills Codex pour démarrer

Vous n'avez pas à tout écrire vous-même. Pour une sélection de skills Codex à installer, voyez nos meilleurs skills Codex. Pour parcourir par tâche — test, revue, refactoring — partez du catalogue de skills ou de la catégorie développement. Comme le format SKILL.md est partagé entre agents, beaucoup de skills écrits pour d'autres outils se glissent dans ~/.agents/skills/ sans (ou presque) modification.

Les skills transforment Codex d'un assistant généraliste en un assistant qui suit votre playbook. Commencez par un skill pour votre tâche la plus répétitive, soignez sa description, et ajoutez-en à mesure que le pattern fait ses preuves.