Comment écrire de bons Skills pour vos agents IA

Publié le 3 novembre 2026 par Adrien Crovetto

La semaine dernière, vous avez écrit un super prompt. Le résultat était exactement ce que vous vouliez. Cette semaine, vous en avez de nouveau besoin. Vous ne le retrouvez pas, vous le réécrivez de mémoire, et la réponse est différente.

Le problème n'est pas votre prompt. C'est qu'un prompt est jetable. Vous l'écrivez, vous l'utilisez une fois, et il disparaît dans l'historique d'une conversation.

Un skill règle ce problème. C'est un prompt que vous écrivez une fois, rangé dans un dossier, et que votre agent relit chaque fois que la tâche revient. Cet article explique pourquoi les skills sont le nouveau prompt engineering, comment fonctionne le standard ouvert, et 8 règles pour écrire des skills que votre agent suit vraiment.

Fait partie de notre série sur les agents IA

Les skills sont l'une des 5 briques d'un agent. Si ce n'est pas encore fait, commencez par notre guide complet sur les agents IA.

En un coup d'œil

#	Section	Ce que ça change
1	Les skills, le nouveau prompt engineering	Vous arrêtez de réécrire les mêmes instructions
2	Le standard Agent Skills	Un skill fonctionne sur de nombreux agents
3	8 règles pour écrire un bon skill	Votre agent suit la procédure, pas son imagination
4	Un modèle prêt à l'emploi	Vous partez d'une structure qui marche

Les skills, le nouveau prompt engineering

Pourquoi c'est important

Pensez à un nouvel employé : vous ne lui dictez pas chaque tâche à voix haute tous les matins, vous lui donnez accès a votre base de connaissance, souvent le drive de l'entreprise. Et selon ses taches, il va chercher le bon document, lire la procédure et l'appliquer.

C'est exactement la meme chose pour une IA avec les skills: quand vous donnez une tache à l'IA elle va chercher dans ses skills si l'un d'entre eux peux lui etre utile. Ensuite elle charge son contenu et l'applique avant de vous répondre.

Avec le temps, vous allez vous construire une collection de skills qui seront le coeur de votre entreprise. Vos IA les utiliseront sans même que vous vous en rendiez compte.

Rien de ce que vous avez appris sur les prompts n'est perdu. Être précis, donner des exemples, imposer le format de sortie : tout s'applique encore, comme on l'explique dans comment rédiger de bons prompts. La différence, c'est que l'effort se cumule. Un bon prompt aide une fois. Un bon skill aide à chaque fois. Une bonne bibliothèque de skills met votre entreprise en pilotage automatique.

Le standard Agent Skills

Pourquoi c'est important

Si chaque outil inventait son propre format, vous devriez réécrire vos skills pour chaque modèle d'IA. Le standard Agent Skills règle ça : un même skill est utilisable par plusieurs agents.

C'est un format ouvert, développé à l'origine par Anthropic puis publié comme standard ouvert. Il est aujourd'hui pris en charge par de nombreux outils, dont Claude Code, Cursor, GitHub Copilot, VS Code, Gemini CLI, OpenAI Codex ou encore Haloon.

L'idée est simple. Un skill est un dossier avec un seul fichier obligatoire :

mon-skill/
├── SKILL.md          # Obligatoire : métadonnées + instructions
├── scripts/          # Optionnel : code exécutable
├── references/       # Optionnel : documentation complémentaire
└── assets/           # Optionnel : modèles, ressources

SKILL.md commence par un court en-tête (le frontmatter), suivi de vos instructions en Markdown simple :

---
name: relance-client
description: Rédige un mail de relance après un rendez-vous client. À utiliser quand l'utilisateur parle de compte rendu, de relance ou de suivi de devis.
---

# Relance client

1. Lire les notes du rendez-vous
2. ...

Seuls deux champs sont obligatoires :

Champ	Règle
name	64 caractères maximum. Minuscules, chiffres et tirets uniquement. Doit correspondre au nom du dossier.
description	1 024 caractères maximum. Dit ce que fait le skill et quand l'utiliser.

Quatre champs optionnels existent (license, compatibility, metadata, allowed-tools, ce dernier encore expérimental). La plupart des skills n'en ont pas besoin.

La divulgation progressive : l'idée qui fait tout marcher

Un agent ne peut pas lire 50 skills en entier avant chaque tâche. Il les charge donc en trois temps :

1. Découverte : au démarrage, l'agent lit seulement le name et la description de chaque skill (environ 100 tokens: rapide et efficace).
2. Activation : quand votre demande correspond à une description, il lit le SKILL.md complet.
3. Exécution : il suit les instructions et n'ouvre les fichiers supplémentaires que si besoin.

Deux conséquences pour vous. La description décide si votre skill sera un jour utilisé. Et le corps doit rester léger : la spécification recommande moins de 500 lignes et environ 5 000 tokens.

8 règles pour écrire un bon skill

1. Partez d'un vrai travail, pas d'une page blanche

Demander à une IA d'"écrire un skill sur X" donne des conseils vagues du genre "suivre les bonnes pratiques". Faites plutôt la tâche une fois avec votre agent. Corrigez-le en route. Puis transformez ce qui a marché, et ce que vous avez dû corriger, en skill.

❌	✅
Écris-moi un skill pour les mails clients	Faites 3 vrais mails clients avec l'agent, notez chaque correction, puis écrivez le skill

2. Écrivez la description comme un déclencheur

La description est ce que l'agent voit en permanence. Elle doit dire ce que fait le skill et quand l'utiliser, avec les mots que vous utiliseriez vraiment.

❌	✅
Aide pour les mails	Rédige les mails de relance après un rendez-vous client, dans notre ton. À utiliser quand l'utilisateur parle de compte rendu, de relance ou de rappel de devis.
Rédige un article de blog	Rédige, design et publie les articles de blog de l'entreprise. Gère tout le cycle de vie: écriture, génération d'image et vidéo, publication et performance SEO

3. Ajoutez ce que l'agent ne sait pas. Coupez le reste

L'agent sait déjà ce qu'est un mail. Il ne connaît pas votre ton, votre signature, ni le fait que vous n'envoyez jamais un devis sans date de validité. Pour chaque ligne, demandez-vous : "L'agent se tromperait-il sans elle ?" Sinon, supprimez-la.

4. Un skill, un métier cohérent

Il y a un équilibre a trouver sur la surface couverte par un fichier SKILL.md

• Trop étroit, et plusieurs skills doivent se charger pour une seule tâche. Vous consommez plus de token et votre agent met plus de temps à vous répondre.
• Trop large, et le skill ne se déclenche jamais précisément. Ou alors il se déclanche pour les mauvaises raisons et vous récupéré un résultat érroné.

❌	✅
Gérer tout ce qui touche aux clients	Rédiger une relance client

5. Donnez un choix par défaut, pas un menu

Quand plusieurs approches fonctionnent, choisissez-en une et mentionnez l'alternative en une ligne.

❌	✅
Vous pouvez écrire un mail court, moyen ou long, formel ou décontracté.	Écris 5 à 8 lignes, ton formel. Pour les clients de longue date, utilise le prénom

6. Gardez une section "Pièges"

Le contenu le plus précieux d'un skill est souvent une courte liste de pièges dans lesquels l'agent retombe. Chaque fois que vous corrigez l'agent, ajoutez la correction ici (on l'appelle "Gotchas" dans le standard).

## Pièges

- Nos devis sont valables 30 jours. Toujours écrire la date de fin exacte.
- Ne jamais promettre une date de livraison. Écrire "nous confirmons d'ici vendredi".

7. Strict là où c'est fragile, libre ailleurs

Un ton de voix tolère la variation : expliquez le pourquoi et laissez l'agent s'adapter. Une mention légale ou une commande qui doit s'exécuter exactement comme écrite : écrivez "ne pas modifier".

8. Testez, lisez les traces, itérez

Votre première version sera fausse quelque part. Lancez le skill sur de vraies tâches. Regardez ce que l'agent a fait, pas seulement le résultat. Des instructions trop vagues le poussent à essayer plusieurs approches. Des instructions qui ne s'appliquent pas, il les suit quand même. Coupez, clarifiez, relancez. Un seul tour change déjà nettement la qualité.

Astuce

Besoin de plus de détails ? Ne les ajoutez pas dans SKILL.md. Mettez-les dans references/ et dites à l'agent quand les lire : "Lis references/tarifs.md si le client parle de remise." Un vague "voir references" ne sera pas suivi.

Un modèle prêt à l'emploi

Copiez ceci, remplacez les crochets, et enregistrez-le sous le nom SKILL.md dans un dossier qui porte le nom de votre skill.

---
name: [nom-court-avec-tirets]
description: [Ce que ça fait]. À utiliser quand [situations et mots-clés qui doivent le déclencher].
---

# [Titre du skill]

## Procédure

1. [Première étape, avec la source exacte à lire]
2. [Deuxième étape, avec le choix par défaut]
3. [Vérification avant de terminer]

## Format de sortie

[Court modèle du résultat attendu]

## Pièges

- [Piège dans lequel l'agent tombe, et la correction]
- [Un autre]

## Jamais

- [Ce qui demande une validation humaine, par exemple : ne jamais envoyer, seulement préparer un brouillon]

Avec Haloon Agent

Les processus de votre équipe deviennent des skills, et votre agent devient compétent sur votre façon de travailler. Nous vous accompagnons dans la rédaction et la mise en place des fichiers SKILL.md.

Résumé

#	Règle	Pourquoi
1	Partez d'un vrai travail	Les vraies corrections valent mieux que des conseils génériques
2	Écrivez la description comme un déclencheur	Elle décide si le skill est utilisé
3	Ajoutez ce que l'agent ne sait pas	Chaque ligne inutile consomme de l'attention
4	Un skill, un métier	Activation précise, pas de conflits
5	Donnez un défaut, pas un menu	Moins d'hésitations
6	Gardez une section Pièges	Les lignes les plus précieuses
7	Strict où c'est fragile, libre ailleurs	Du contrôle sans rigidité
8	Testez et itérez	Le premier jet n'est jamais le dernier

Un skill est un petit fichier avec un gros effet : vous écrivez votre expertise une fois, et votre agent l'applique à chaque fois. Commencez par une tâche que vous répétez chaque semaine et écrivez son skill aujourd'hui.

Envie de le voir en action ? Essayez Haloon et transformez votre première routine en skill. Pour revenir aux bases, lisez notre guide complet sur les agents IA.