La réponse courte
- 1Placez le dossier du Skill dans
~/.agents/skills/pour l’utiliser dans tous vos dépôts, ou dans le.agents/skills/d’un dépôt pour l’y réserver. - 2Codex exige à la fois
name(jusqu’à 64 caractères) etdescription(jusqu’à 1 024) dansSKILL.md. - 3Tapez
$suivi du nom du Skill pour l’exécuter, ou/skillspour le choisir dans une liste. - 4Vous en voulez des tout prêts ? Parcourez les Skills Codex à installer en une commande.
Avant de commencer
Les Skills fonctionnent à trois endroits : la Codex CLI, l’extension IDE Codex et Codex dans l’application de bureau ChatGPT. Pour installer depuis Skillry avec la CLI, il vous faut aussi macOS ou Windows et Node.js 22 ou plus récent.
Comment ajouter des Skills à Codex
Codex et la CLI Skillry utilisent le même dossier par défaut, ~/.agents/skills/ : aucune option supplémentaire n’est donc nécessaire. Choisissez la méthode qui vous convient.
- 1
Ouvrez le Skill sur Skillry, sélectionnez Copier le prompt d’installation, puis Copier dans la fenêtre.
- 2
Collez-le dans Codex et envoyez-le. L’agent lit les instructions d’installation de Skillry et exécute lui-même la bonne commande.
Prompt d’installation Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
Quand votre navigateur vous demande d’approuver un code d’appareil, approuvez-le.
Vous devriez voir : Codex indiquant la version installée et le dossier utilisé, sous
~/.agents/skills/.
- 1
Connectez-vous une fois. Une fenêtre de navigateur s’ouvre avec un code d’appareil à approuver.
Terminal npx --yes skillry-cli@latest login - 2
Installez. Aucune option n’est nécessaire, car le dossier par défaut de la CLI est celui que lit Codex.
Terminal npx --yes skillry-cli@latest install <slug>Vous devriez voir :
Installed <slug> <version> to ~/.agents/skills/<slug>
Sélectionnez Télécharger le ZIP sur la page du Skill, ou utilisez un dossier de Skill obtenu ailleurs. Lisez SKILL.md et le contenu de scripts/ avant d’installer, car l’agent suit ces instructions et peut exécuter ces scripts. Déplacez ensuite le dossier entier :
mkdir -p ~/.agents/skills
mv ~/Downloads/my-skill ~/.agents/skills/Les ZIP se décompressent souvent avec un niveau en trop, comme my-skill/my-skill/SKILL.md. SKILL.md doit se trouver directement dans le dossier du Skill, sinon l’agent ne le trouvera pas.
Codex dispose aussi de son propre installateur pour le catalogue d’OpenAI, $skill-installer. Il place les Skills dans ~/.codex/skills/, un ancien dossier que Codex lit toujours : les Skills des deux installateurs apparaissent donc ensemble.
Vérifier que Codex l’a trouvé
Dans la CLI ou l’extension IDE, tapez /skills, ou tapez $ et commencez à saisir le nom. Dans l’application de bureau ChatGPT, ouvrez Skills dans la barre latérale. Codex détecte tout seul les nouveaux Skills ; si l’un d’eux n’apparaît pas, redémarrez Codex.
Comment exécuter un Skill dans Codex
Tapez $, le nom du Skill, puis votre demande :
$launch-page Parcelo, a parcel-tracking dashboard for small online shopsUne fois que vous savez qu’il fonctionne, vous pouvez formuler votre demande en langage courant, et Codex choisit le Skill dont la description correspond. Avec beaucoup de Skills installés, Codex raccourcit les descriptions pour que toute la liste tienne dans environ 2 % de la fenêtre de contexte. Placez l’usage principal dans la première phrase de la description pour qu’il survive à la coupe.
Où Codex cherche les Skills
Codex rassemble les Skills depuis cinq portées. Au quotidien, vous en utiliserez deux : votre dossier personnel et celui du dépôt.
| Portée | Emplacement |
|---|---|
| Dépôt | .agents/skills/ dans chaque dossier, de celui où vous lancez Codex jusqu’à la racine du dépôt |
| Personnel | ~/.agents/skills/ |
| Personnel, ancien | ~/.codex/skills/, toujours lu (absent de la documentation, mais confirmé dans le code source de Codex) |
| Admin | /etc/codex/skills/ |
| Système | Fournis avec Codex, comme $skill-creator et plan |
Codex ne fusionne pas deux Skills portant le même nom. Les deux peuvent apparaître dans le sélecteur : supprimez ou renommez donc la copie dont vous ne voulez pas.
Skills Codex vs AGENTS.md
Codex lit AGENTS.md au début de chaque exécution : il convient donc aux règles courtes qui s’appliquent toujours. Un Skill ne se charge que lorsqu’une tâche le demande : il convient donc aux procédures plus longues que vous répétez.
Chargé au besoin
- Un dossier dans
.agents/skills/ - Se charge quand une tâche correspond, ou quand vous tapez
$name - Idéal pour un travail répétable en plusieurs étapes
Lu au début de chaque exécution
~/.codex/AGENTS.mdd’abord, puis un fichier par dossier, de la racine du dépôt jusqu’au dossier de départ- Les fichiers les plus proches remplacent les précédents ; 32 Kio au total par défaut
- Idéal pour des règles courtes : commandes de test, style de code, limites
Une répartition qui fonctionne bien : limitez AGENTS.md à environ un écran de règles, et déplacez tout ce qui se fait étape par étape dans des Skills. Skills vs instructions approfondit le sujet.
Votre Skill Codex n’apparaît pas ? Repérez votre symptôme
Un Skill manquant se trouve généralement dans le mauvais dossier ou a été décompressé un niveau trop bas. Repérez ce que vous voyez dans la colonne de gauche.
| Ce que vous voyez | Solution |
|---|---|
Absent de /skills | Déplacez-le dans ~/.agents/skills/<name>/ et vérifiez qu’il n’y a pas de niveau en trop venu du ZIP |
| Listé sans description | Corrigez le frontmatter. Codex exige à la fois name et description |
| Skill de projet manquant | Lancez Codex depuis l’intérieur du dépôt |
$ ne trouve rien dans l’application de bureau ChatGPT | Un bug signalé (openai/codex#28505). Vérifiez /skills, redémarrez, ou essayez une copie dans ~/.codex/skills/ (nous ne l’avons pas encore testé) |
Questions fréquentes
Où sont stockés les Skills Codex ?
~/.agents/skills/ pour vos propres Skills, .agents/skills/ dans un dépôt, et /etc/codex/skills/ pour les administrateurs. Codex lit aussi l’ancien ~/.codex/skills/, là où $skill-installer place les Skills.
Quelle est la différence entre les Skills Codex et AGENTS.md ?
AGENTS.md est lu au début de chaque exécution. Un Skill ne se charge que lorsqu’une tâche en a besoin.
Les Skills Codex fonctionnent-ils dans ChatGPT ?
Les Skills autonomes fonctionnent dans l’application de bureau ChatGPT, la Codex CLI et l’extension IDE. Pour en utiliser un dans ChatGPT sur le web ou sur mobile, distribuez-le dans un plugin.
Comment créer mon propre Skill Codex ?
Demandez à $skill-creator. C’est l’un des Skills système fournis avec Codex.
Sources
Ce guide vous a-t-il aidé ?
