Vous savez écrire un bon prompt ? Faites-en une skill

Vous savez écrire un bon prompt ? Tant mieux. Mais si vous vous en servez tous les jours, vous allez le retaper des dizaines de fois, avec à chaque fois une petite variante. Il y a deux façons de gérer ça. La première devient vite pénible. La seconde, c’est la skill.

Un bon prompt, en rappel

Un bon prompt donne au modèle ce qu’un collègue compétent vous demanderait avant de commencer :

• Le contexte : qui vous êtes, pour qui est le résultat, et pourquoi vous en avez besoin.
• La tâche, dite simplement, en une ou deux phrases.
• Les contraintes : longueur, ton, format, et ce qu’il ne faut pas faire.
• Un exemple du résultat attendu, quand vous en avez un.
• Quoi faire s’il manque une information : poser la question plutôt qu’inventer.
• Comment vérifier : les critères que le résultat doit remplir.

Par exemple, pour auditer un site :

Audite le site cabinet-durand.fr. C’est un cabinet d’avocats à Lyon.
Trois axes : sécurité et conformité, technique et performance, SEO.
Tests passifs uniquement : pas de scan actif, pas d’envoi de formulaire.
Si le site ne répond pas, arrête-toi et explique pourquoi.
Livre un rapport en français, avec les correctifs classés par priorité.

Le problème : vous allez le retaper

Ce prompt marche. Demain, vous auditerez un autre site, d’un autre secteur, peut-être en anglais. Vous recopierez le prompt, changerez trois mots, oublierez une ligne, et le résultat sera un peu moins bon sans que vous sachiez pourquoi. Et quand vous l’améliorerez dans une conversation, l’amélioration restera dans cette conversation.

Option 1 : un catalogue de prompts

Le réflexe naturel, c’est un document ou une page Notion où l’on range ses meilleurs prompts. Au début, ça aide. Puis ça devient fastidieux : il faut retrouver le bon prompt, le copier, remplacer les valeurs à la main, le coller. Les versions se multiplient, les améliorations faites en cours de route n’y reviennent jamais, et vos agents, eux, ne savent pas que ce catalogue existe.

Option 2 : une skill modulable

Une skill est un fichier texte, SKILL.md, rangé dans un dossier que votre outil d’IA lit. Il contient un nom, une ligne qui dit quand l’utiliser, puis les instructions. Dans Claude Code, la skill se lance quand vous tapez son nom, /audit-site par exemple, ou quand votre demande correspond à sa description.

Elle devient modulable quand vous séparez ce qui change de ce qui reste. Ce qui change devient des paramètres, chacun avec une valeur par défaut. Ce qui reste, les règles, le format et les vérifications, est écrit une fois pour toutes. Voici le début de ma skill d’audit :

---
name: audit-site
description: Audit passif d’un site web sur trois axes (sécurité,
  technique, SEO). À utiliser quand je tape /audit-site ou que je
  demande d’auditer un site.
argument-hint: "<url> [secteur=avocat|santé|e-commerce] [pays=FR] [langue=fr] [max=300] [format=html|pdf|md]"
---

## Paramètres (défaut si absent)
- URL : premier argument, obligatoire. La demander si elle manque.
- Secteur : à déduire du contenu du site.
- Pays et droit applicable : France.
- Langue du rapport : français.
- Plafond : 300 pages. Au-delà, échantillonner et le signaler.
- Format : rapport Markdown + page HTML autonome.

## Cadre
- Tests passifs uniquement. Pas de scan actif, pas de formulaire.
- Ne contacter personne : on rédige le rapport, rien n’est envoyé.
- Si le site ne répond pas : s’arrêter et expliquer pourquoi.

Il me suffit maintenant de taper /audit-site cabinet-durand.fr secteur=avocat. Le reste est déjà écrit. Et pour un site anglais, j’ajoute langue=en, sans toucher au reste.

Les avantages s’additionnent :

• Un seul endroit à améliorer. Quand un résultat me déçoit, je corrige la skill, pas la conversation.
• Une skill peut emporter ses fichiers de référence et ses scripts : une grille d’analyse, un modèle de rapport.
• Mes agents l’utilisent aussi, et la même skill sert à Claude Code et à Codex.

Ce qu’une skill peut faire de plus

Jusqu’ici, une skill ressemble à un prompt bien rangé. Elle peut aller beaucoup plus loin.

Emporter ses fichiers

Le dossier d’une skill peut contenir autre chose que le SKILL.md : des fichiers de référence et des scripts. Ma skill newsletter a un dossier references/ avec ma méthode éditoriale et le profil de la newsletter, qu’elle relit à chaque édition. Seule la description de chaque skill est chargée en permanence. Le reste n’est lu qu’au moment où la skill sert, et vous pouvez donc en avoir des dizaines sans encombrer l’IA.

Se brancher à vos outils : API et MCP

Une skill peut appeler des API et des serveurs MCP, ces connecteurs qui donnent à l’IA l’accès à vos outils. Ma skill d’audit interroge l’API PageSpeed Insights de Google pour mesurer la vitesse du site. Une skill de relance peut lire vos e-mails et votre agenda via un serveur MCP, et déposer un brouillon dans Gmail. Le brouillon attend votre clic : la skill prépare, vous envoyez.

Choisir le format du résultat

Le format de sortie peut devenir un paramètre comme les autres : format=html, format=pdf, format=md, ou un Google Doc. Ma skill d’audit livre par défaut un rapport en Markdown et une page HTML autonome, qu’on peut ouvrir dans un navigateur ou envoyer telle quelle. Avec format=pdf, le même audit sort en PDF, sans changer une ligne du reste.

Poser des questions avant d’agir

Une skill n’est pas obligée de foncer. Ma skill newsletter commence par me demander le ton de l’édition, puis me pose deux ou trois questions pour enrichir mes notes avant d’écrire. C’est la différence entre un modèle de texte et un collaborateur : elle va chercher ce qui manque au lieu de l’inventer.

Laisser le code faire ce que fait le code

Tout ce qui doit donner le même résultat à chaque fois va dans un script : une mesure, un calcul, une mise en page. Le modèle garde ce qui demande du jugement. Ma skill d’audit mesure les en-têtes et la vitesse avec des commandes, et le modèle explique ce que ça veut dire et quoi corriger. Ma skill de vidéo écrit le scénario, puis des outils assemblent le montage.

Soigner la description

C’est la description qui décide si la skill se déclenche toute seule. « Aide pour les audits » est trop vague : l’IA ne saura pas quand s’en servir. « À utiliser quand je tape /audit-site ou que je demande d’auditer un site » dit exactement quand elle s’applique.

Règle, skill ou agent ?

Les trois se ressemblent, mais ne servent pas au même moment.

Tester et faire évoluer une skill

Une skill se teste comme un outil. Avant de m’y fier, je la rejoue sur deux ou trois cas déjà traités à la main et je compare les résultats. Ensuite, chaque déception devient une correction : une ligne de plus dans les règles, un paramètre, un exemple. Une skill étant un simple fichier texte, rangez-la dans git : vous pourrez revenir à une version précédente. Et comme Claude Code et Codex lisent le même dossier, une correction sert aux deux outils à la fois.

Transformer votre prompt en skill

1. Prenez le prompt que vous avez le plus utilisé ce mois-ci.
2. Séparez ce qui change d’une fois sur l’autre de ce qui reste identique.
3. Donnez à chaque paramètre une valeur par défaut, et dites quoi faire si un paramètre obligatoire manque.
4. Écrivez une ligne qui dit quand utiliser la skill.
5. Enregistrez le tout dans un fichier SKILL.md, dans un dossier au nom de la skill, sous ~/.claude/skills/.
6. Chaque fois que le résultat vous déçoit, corrigez la skill.

Vous pouvez même demander à l’IA de faire la conversion : collez votre prompt et demandez-lui d’en faire une skill avec des paramètres.