Pour créer une skill, choisis une tâche que ton agent sait déjà réaliser, écris sa méthode dans un fichier SKILL.md, puis teste-la sur plusieurs entrées différentes

Le bénéfice arrive au deuxième usage : tu retrouves une procédure, un format de résultat et des critères de contrôle sans refaire tout le brief

Prends une tâche très ordinaire : extraire les décisions d'un compte rendu de réunion

La première fois, tu expliques de citer les passages, de séparer une proposition d'une décision et de signaler les responsables manquants. La semaine suivante, tu recommences. Une skill permet de garder ces règles au même endroit

Ce que contient une skill

Le format Agent Skills rassemble des instructions et, si nécessaire, des ressources utilisables par un agent compatible

Dans la spécification du format, le minimum est un dossier contenant SKILL.md. Le fichier commence par un nom et une description, puis donne la méthode en Markdown. Des scripts, références et modèles peuvent compléter le dossier

Commence avec ce minimum. Un script devient utile lorsqu'une partie du travail exige un calcul ou une transformation reproductible. Une référence devient utile lorsque son contenu sert réellement à la tâche

La skill décrit comment travailler. Les connecteurs et le protocole MCP donnent accès à des outils ou à des données. Tu peux avoir une excellente procédure sans accès au fichier nécessaire ; l'agent doit alors signaler ce manque

Choisir une tâche assez précise

« Aide-moi dans mon travail » demande trop de décisions implicites

« Extrais les décisions et les actions d'un compte rendu fourni » donne une entrée, une transformation et une sortie contrôlables

Avant d'écrire le fichier, réponds à quatre questions :

• Quelle entrée dois-je fournir ?

• Quel résultat dois-je retrouver ?

• Quelles erreurs dois-je pouvoir détecter ?

• Quelles actions dépassent la mission ?

Dans notre exemple, l'entrée est un compte rendu, le résultat est une liste sourcée et l'erreur critique serait de transformer une idée évoquée en engagement pris

Le cas suivant est un exemple pédagogique. Il ne contient aucune réunion ni donnée client réelle

Un exemple complet de SKILL.md

Crée un dossier nommé extraire-decisions-reunion contenant ce fichier :

La description précise quand utiliser cette compétence. Le corps indique le résultat attendu et les erreurs à éviter. Le lecteur peut comprendre la méthode sans connaître le système qui exécutera le fichier

Pour la faire écrire par ton agent, tu peux aussi lui demander :

Transforme notre méthode de suivi de réunion en skill compatible avec mon outil. Garde les sources, les inconnues et les limites d'action. Montre-moi le fichier avant installation et explique comment vérifier qu'il est bien chargé

La rendre disponible dans ton outil

Le chemin d'installation dépend de l'application. Vérifie la documentation de ton agent plutôt que de copier un emplacement prévu pour un autre produit

Demande-lui ensuite de confirmer le nom de la skill, son chemin et le fichier réellement lu. Invoque-la explicitement pour le premier essai. Tu pourras tester sa sélection automatique ensuite

Un fichier présent sur le disque ne prouve pas qu'une application l'a chargé. Une réponse qui ressemble au format attendu ne le prouve pas davantage : vérifie le mécanisme de chargement disponible dans ton outil

Si tu découvres encore ces usages, le guide Codex pour non-développeurs explique comment préparer un dossier et cadrer une mission

Trois essais avant de la réutiliser

Teste d'abord la méthode sur de petits textes dont tu connais la réponse

Ajoute ensuite un document contenant deux versions contradictoires d'une échéance. La bonne sortie doit te montrer le désaccord

Tu testes deux dimensions : le résultat produit et le comportement en cas de manque. Une jolie synthèse qui invente un responsable échoue au test

Pour aller plus loin, utilise la méthode d'évaluation d'un agent IA et garde les entrées de test pour comparer les versions

Corriger la méthode au bon endroit

Si l'agent mélange systématiquement proposition et décision, ajoute un exemple de cette distinction dans la skill

Si un seul compte rendu est ambigu, note cette ambiguïté dans le résultat. Inutile d'ajouter une règle permanente pour chaque formulation rencontrée

Quand tu modifies la procédure, relance les anciens essais. Une précision peut résoudre une erreur et rendre la skill trop restrictive ailleurs

Une bonne maintenance reste légère : conserver le fichier, les cas de test et une courte explication des changements importants

Les permissions restent dans l'environnement

Écrire « ne pas envoyer » aide à cadrer le comportement. Pour les tâches sensibles, configure aussi les accès de l'outil : lecture seule, dossier dédié ou validation avant action

Inspecte les skills récupérées ailleurs, particulièrement leurs scripts. Une compétence ajoutée à ton agent peut lui faire exécuter du code ou contacter un service selon les permissions disponibles

Pour un premier essai, utilise des données fictives et aucun accès de production

Ta première skill peut tenir sur une page

Choisis une procédure que tu répètes déjà. Écris l'entrée, la méthode, le résultat et les erreurs à éviter. Teste les cas normaux, incomplets et contradictoires

Tu disposes alors d'une base concrète pour déléguer la même tâche avec moins de répétition et un résultat plus facile à contrôler

Pour construire cette méthode autour de tes propres tâches, découvre l'accompagnement Kryve sur les agents IA