Après quelque temps avec un agent IA, les mêmes explications reviennent. Les points à vérifier lors d’une revue. L’ordre d’une mise en production. Les sources à consulter avant de conclure. Enfermées dans une conversation, ces consignes disparaissent avec elle.
Les Agent Skills conservent cette méthode dans un dossier. Le fichier central s’appelle SKILL.md. Des références, scripts et modèles peuvent l’accompagner lorsque le travail l’exige.
Plus qu’un long prompt
Une compétence n’est pas un entrepôt de connaissances diverses. Elle décrit un travail précis : par où commencer, quoi contrôler, quand s’arrêter et quoi rendre. La procédure reste assez claire pour être suivie par quelqu’un d’autre. L’agent peut faire de même.
L’agent ne lit pas d’emblée le contenu intégral de chaque compétence installée. Il commence par leurs métadonnées. Si une demande correspond, il ouvre le fichier SKILL.md retenu puis les documents complémentaires indiqués par celui-ci. Le détail n’arrive qu’au moment utile.
Un index compact des travaux possibles
Procédure, jugement, critères de fin
Contexte détaillé, traitements, modèles
Ce que contient une compétence
Seul SKILL.md est obligatoire. Le reste doit justifier sa présence par les besoins du travail. Une compétence simple peut rester simple.
SKILL.mdBut, déclenchement, procédure, résultatRequisreferences/Règles, spécifications, contexte détailléAu besoinscripts/Calculs ou traitements déterministesAu besoinassets/Modèles et ressources pour le résultatAu besoinagents/openai.yamlMétadonnées d’interface et d’outilsFacultatifUne première version utile peut tenir en quelques lignes :
---
name: product-copy-review
description: Review product copy before publication. Use for English,
Japanese, or French web copy; do not use for legal review.
---
1. Read the page in its full context.
2. Flag unclear claims and repeated wording.
3. Preserve technical meaning while revising.
4. Return the revised copy with a short reason for each material change.La description n’est pas un texte promotionnel. C’est une règle d’aiguillage. Préciser le travail visé et sa limite aide l’agent à choisir la compétence pour de bonnes raisons.
La place d’une compétence
Lorsque deux mécanismes se ressemblent, leur durée et leur responsabilité permettent de les séparer.
| Mécanisme | Usage adapté | Caractère |
|---|---|---|
| Prompt | La demande présente | Façonné pour une tâche |
AGENTS.md et équivalents | Les conventions permanentes du dépôt | S’applique dans son périmètre |
| Compétence | Une procédure répétable | Chargée pour le travail concerné |
| Serveur MCP | Données en direct, authentification, actions | Fournit informations et outils |
| Plugin | Distribution de compétences et connexions | Regroupe des capacités liées |
Un serveur MCP peut récupérer l’activité d’un compte client. Une compétence peut indiquer comment en tirer une note de synthèse, quelles incertitudes signaler et ce que le document final doit contenir. L’un fournit la capacité. L’autre fournit la méthode.
Une bonne compétence reste étroite
Une compétence très large paraît commode jusqu’au moment où son déclenchement et son critère de réussite deviennent impossibles à formuler. Mieux vaut circonscrire un travail continu, avec une entrée reconnaissable et un résultat vérifiable.
Ce qui arrive
Ce qui doit être vérifié
Ce qui doit être rendu
- Nommer les éléments attendus en entrée.
- Définir ce qui constitue un travail terminé.
- Indiquer les faits que l’agent ne doit pas inventer.
- Marquer les moments où il doit demander ou s’arrêter.
- Expliquer quand ouvrir les documents complémentaires.
Les essais ne doivent pas se limiter à la demande idéale. Il faut tester un appel direct, une formulation indirecte, une demande incomplète, un cas qui ne doit pas déclencher la compétence et un cas limite. Une erreur de sélection pointe souvent vers la description. Un résultat instable pointe plutôt vers les instructions.
Un format partagé, des détails locaux
Les Agent Skills disposent d’une spécification ouverte. Les chemins de découverte et les modes d’appel ne sont pourtant pas identiques dans tous les agents. La structure et la méthode peuvent être partagées. Le placement final dépend encore du produit qui les utilise.
Codex cherche les dossiers .agents/skills depuis le répertoire de travail jusqu’à la racine du dépôt. Les compétences personnelles peuvent vivre dans $HOME/.agents/skills, celles de l’administrateur dans /etc/codex/skills. Pour une diffusion plus large, une compétence peut être intégrée à un plugin.
Un même nom de dossier ne garantit pas un comportement identique dans chaque agent. Les champs acceptés, les emplacements parcourus et les métadonnées complémentaires diffèrent encore.
Une compétence n’est pas une autorisation
Une compétence est un ensemble d’instructions. Elle n’accorde aucun accès supplémentaire au réseau, aux fichiers ou aux identifiants. Les actions authentifiées restent soumises au service connecté. Les opérations sensibles restent soumises aux validations, au bac à sable et aux règles de l’agent.
Les fichiers placés dans scripts/ sont du code exécutable. Avant d’installer une compétence inconnue, il faut lire ses instructions, ses scripts et ses dépendances.
Rendre la méthode visible
L’intérêt d’une compétence n’est pas de donner à l’agent des airs d’outil universel. La méthode reste dans un fichier. On peut la lire, la modifier, examiner ses différences et décider quelle part du travail mérite d’être répétée sans lui céder le jugement qui l’entoure.
C’est une raison très concrète d’utiliser les Agent Skills : l’instruction cesse d’être magique et devient une matière que l’on peut examiner.
Sources
La prise en charge des produits évolue. Cet article a été vérifié à partir de la documentation publique disponible le 7 août 2026.