1. Qu'est-ce qu'un Codex Skill : passer des prompts ponctuels aux scénarios réutilisables
Lors du développement régulier avec Codex, les ingénieurs répètent souvent le même ensemble d'instructions initiales : quels fichiers auditer, selon quels critères, quelles règles architecturales respecter et dans quel format retourner le résultat. Devoir retaper ces exigences à chaque session réduit la productivité et engendre des erreurs aléatoires.
Un Codex Skill (compétence) est un scénario de travail sauvegardé et réutilisable pour un type de tâche spécifique. Créer une compétence ne consiste pas en un fine-tuning du modèle : les poids de l'IA restent inchangés. L'agent reçoit plutôt un protocole procédural clair qu'il charge dynamiquement dans sa fenêtre contextuelle uniquement lorsque la tâche correspondante survient.
Dans l'écosystème officiel OpenAI, les compétences sont déjà utilisées comme standard d'automatisation. Par exemple, pour migrer une base de code vers de nouveaux modèles, OpenAI fournit une Skill prête à l'emploi openai-docs, qui connaît toutes les subtilités du SDK actuel sans nécessiter de chargement manuel de la documentation.
2. Critères de sélection : quand utiliser un Skill versus un prompt classique
Les Skills sont destinés avant tout aux processus présentant une répétitivité marquée, une séquence d'actions stable ou des exigences strictes sur le format des données de sortie.
| Critère | Prompt classique | Codex Skill |
|---|---|---|
| Fréquence d'utilisation | Tâche unique et ponctuelle | Scénario régulier (quotidien ou avant chaque release) |
| Complexité du processus | 1–2 étapes simples | Pipeline multi-étapes réglementé avec validation |
| Fichiers supplémentaires | Non requis | Nécessite des scripts associés, des références ou des check-lists |
| Exigences de format | Réponse libre | Structure de rapport stricte (par ex., JSON ou tableau fixe) |
| Droits et restrictions | Paramètres de session actuels | Actions autorisées et interdites clairement définies |
Scénarios typiques pour la création d'une compétence
- Vérification pré-release du repository : Lancement des linters, recherche de code de debug oublié (
console.log,TODO), vérification de la compatibilité des types. - Code review standardisé : Vérification de la conformité aux règles architecturales internes de l'équipe sans apporter de modifications autonomes.
- Génération de notes de release : Extraction de la liste des PR fusionnés, leur catégorisation et mise à jour du
CHANGELOG.md. - Migration de composants : Refactoring étape par étape de patterns obsolètes selon un template pré-approuvé.
Règle pratique de l'ingénieur : Si vous vous surprenez à expliquer pour la troisième fois à Codex la même séquence d'étapes (« lis d'abord ce fichier, puis lance ce test, ne modifie rien, sors le résultat sous forme de tableau »), il est temps d'emballer ce workflow dans un Skill dédié.
3. Mécanique d'activation : appel explicite via $name vs sélection automatique
Codex prend en charge deux modes d'activation complémentaires des compétences lors d'une session : l'appel direct déterministe par l'utilisateur et la reconnaissance sémantique automatique.
Appel explicite (Explicit Invocation)
L'utilisateur indique directement le nom de la compétence souhaitée via le préfixe dollar $ :
Cette méthode garantit une prévisibilité à 100 % : Codex active immédiatement le Skill indiqué, utilise ses instructions comme base de comportement et les applique aux arguments de votre requête.
Activation automatique (Semantic Auto-Match)
Si le préfixe $name n'est pas spécifié, Codex analyse la requête utilisateur et la confronte au champ description de toutes les compétences connectées :
4. Anatomie d'une compétence et structure SKILL.md : métadonnées, règles et ressources
Une compétence minimale se compose d'un seul fichier — SKILL.md. Les compétences plus matures peuvent inclure des scripts d'automatisation imbriqués, des guides de référence et des templates.
Structure du fichier SKILL.md
Le fichier est divisé en deux parties fonctionnelles : un bloc YAML Frontmatter technique au début et des instructions au format Markdown.
Principe de concision : Ne surchargez pas le SKILL.md avec de longues explications philosophiques. Plus le texte est court et précis, moins il occupe d'espace utile dans la fenêtre contextuelle du modèle, et plus l'agent respecte rigoureusement le règlement.
5. Zones de stockage : compétences projet vs globales personnelles
Codex distingue les compétences selon deux périmètres de visibilité en fonction de leur usage :
Compétences Projet (.codex/skills/ ou .agents/skills/)
Stockées à la racine du repository du projet et versionnées dans Git.
- Usage : Standardisation des processus pour toute l'équipe de développement.
- Avantage : Tout ingénieur (ou runner CI/CD) clonant le repository obtient instantanément le même jeu de compétences agentiques.
Compétences Personnelles (~/.codex/skills/)
Situées dans le répertoire home de l'utilisateur courant du système d'exploitation.
- Usage : Outils individuels spécifiques à un développeur donné (par ex., assistant personnel pour la prise de notes de dev).
- Avantage : Disponibles dans n'importe quel terminal, indépendamment du projet actif.
6. Atelier pratique : créer une compétence de vérification de code avec $skill-creator
La méthode la plus simple et rapide pour créer une nouvelle compétence est d'utiliser le méta-outil système $skill-creator, intégré nativement dans Codex.
Étape 1. Initialisation du générateur
Dans la fenêtre de dialogue Codex, appelez la commande :
Décrivez ensuite le workflow souhaité en langage naturel :
Étape 2. Vérification de l'artefact généré
Le générateur créera le dossier .codex/skills/pr-validator/ et produira le fichier SKILL.md :
Étape 3. Test de la compétence créée en session réelle
Ouvrez une nouvelle session Codex et testez le fonctionnement de la compétence :
Assurez-vous que l'agent a lancé le linter, n'a pas tenté de modifier les fichiers sources et a retourné un tableau de résultats.
7. La triade des capacités de l'agent : Skill, Script et Tool
Les débutants confondent souvent les notions de compétence, script et outil (Tool / MCP). Ils se complètent mais résolvent des problèmes d'ingénierie fondamentalement différents.
Matrice comparative de la triade
| Composant | Rôle dans le système | Mode d'exécution | Exemple |
|---|---|---|---|
| Skill (Compétence) | Règlement et raisonnement | Lu et interprété par le modèle | Instruction pour mener un audit de sécurité |
| Script | Action calculatoire déterministe | Exécuté dans l'OS via le terminal | Script Bash de parsing des tags git |
| Tool (Outil) | Interface d'accès à l'environnement | Appelé via le mécanisme Tool Calling | Serveur MCP pour connexion à l'API GitHub |
La compétence explique à l'agent quoi faire et dans quel ordre. Le script exécute rapidement et fiabillement une opération mathématique ou fichier. L'outil accorde les droits d'interaction avec le monde extérieur.
8. Pilotage programmatique via Skills API et versioning
Au-delà du travail local sur les fichiers, OpenAI fournit une Skills API spécialisée pour le pilotage programmatique des compétences dans les applications cloud et les systèmes backend.
Pourquoi le versioning des Skills est nécessaire
- Immutabilité de l'environnement de production : Chaque mise à jour d'une compétence crée une nouvelle version (
v1,v2). Les pipelines de production s'ancrent sur une version figée précise, éliminant les pannes inattendues dues à des changements accidentels. - Rollback sécurisé : Si une description mise à jour provoque une régression ou une baisse de qualité de la génération de code, l'équipe peut revenir instantanément au numéro de version précédent.
- A/B testing des instructions : Possibilité de comparer simultanément la performance de deux éditions alternatives d'une compétence sur des tâches réelles.
9. Sécurité, limites d'autonomie et règles de confirmation des actions
Un Skill influence directement les opérations que l'agent exécute dans votre système. Il est donc impératif de distinguer clairement, dans le corps de la compétence, les actions autonomes des actions contrôlées.
Matrice des niveaux de confiance
Ne dupliquez pas les interdictions : Évitez de répéter plusieurs fois des phrases telles que « ne modifie rien » dans chaque point. Il suffit de définir clairement une fois les opérations interdites au début de la section des restrictions ; sinon, l'agent deviendra excessivement passif et demandera confirmation même avant de lire un simple fichier.
10. Aide-mémoire final et checklist pour créer un Skill fiable
Conservez cette checklist et référez-vous-y lors de la conception de chaque nouvelle compétence.
Aide-mémoire rapide de l'ingénieur
Checklist de préparation d'une compétence pour la release
- Nom clair : Moins de 64 caractères, en minuscules latines, séparé par des tirets (
kebab-case). - Description informative : Le champ
descriptioncontient une formule claire indiquant « ce que fait la compétence » et « quand elle doit être lancée ». - Corps concis : Texte synthétique respectant le principe de minimisation de l'empreinte contextuelle.