Construis ton premier Skill en 15 minutes (et fais-le se déclencher au bon moment)

ByJean-Yves Hemlin

À la fin de cet article, tu auras un Skill fonctionnel : un dossier, un fichier, une description, et une tâche que tu ne réexpliqueras plus jamais. Quinze minutes, dont cinq pour écrire la seule ligne qui compte vraiment.

J’ai expliqué ailleurs pourquoi un Skill n’est pas un prompt sauvegardé : un prompt, tu te souviens qu’il existe, tu vas le chercher, tu le colles. Un Skill se déclenche tout seul quand le contexte s’y prête, ou à l’appel de son nom. Passons à la fabrication.

Petit rappel de vocabulaire, parce que je l’ai déjà tranché ailleurs : un Skill, au masculin. Il se déclenche, il refuse, il se débogue.

Ce qu’il te faut

Claude Code installé, et surtout : une tâche que tu as refaite au moins trois fois ce mois-ci. Pas une tâche hypothétique. Un compte-rendu de réunion mis au même format, une relecture avant publication, un résumé de tes modifications avant de les valider (commit). Si rien ne te vient, prends celle de l’exemple ci-dessous et adapte-la ensuite.

Étape 1 — Créer le dossier (1 minute)

Un Skill est un dossier contenant un fichier SKILL.md. Deux emplacements possibles :

~/.claude/skills/<nom-du-skill>/SKILL.md    ← personnel, disponible dans tous tes projets
.claude/skills/<nom-du-skill>/SKILL.md      ← projet, partagé avec ton équipe par Git

Le nom du dossier devient la commande que tu tapes. Pour un premier essai, prends le personnel :

# macOS, Linux, ou Git Bash sous Windows
mkdir -p ~/.claude/skills/relecture-avant-publication
# PowerShell (Windows)
New-Item -ItemType Directory -Force ~\.claude\skills\relecture-avant-publication

Choisis un nom qui décrit l’action, en minuscules avec des tirets. C’est ce que tu taperas plus tard : /relecture-avant-publication.

Étape 2 — Écrire le SKILL.md (5 minutes)

Le fichier a deux parties : un en-tête entre --- qui dit quand l’utiliser, et le corps qui dit comment.

---
description: Relit un texte avant publication et signale les affirmations non sourcées,
  les tournures commerciales et les anglicismes évitables. À utiliser quand l'utilisateur
  demande une relecture, une passe finale, ou dit qu'un texte est prêt à publier.
  Ne pas utiliser pour rédiger un texte de zéro, ni pour corriger du code.
---

## Ta tâche

Relis le texte fourni et retourne trois listes distinctes :

1. **Affirmations à sourcer** : chaque chiffre, date ou fait qui n'a pas de lien vers une
   source. Cite la phrase exacte.
2. **Tournures à retirer** : langage commercial, promesses non mesurables, superlatifs.
3. **Anglicismes évitables** : avec l'équivalent français quand il existe.

Ne réécris pas le texte. Signale, propose, laisse-moi trancher.

Le corps, tu peux l’écrire vite : c’est ce que tu expliquerais à quelqu’un qui fait la tâche à ta place.

La description, en revanche, mérite tes cinq minutes. C’est elle seule qui décide si le Skill se déclenche au bon moment, parce que c’est le seul morceau que l’IA lit en permanence pour savoir si ton Skill est pertinent (Claude Code — Extend Claude with skills).

Regarde la structure de celle du dessus : ce qu’il fait, quand l’utiliser, et, la partie que tout le monde oublie, quand ne pas l’utiliser. Cette dernière phrase est ce qui distingue un Skill qui s’active à propos d’un Skill qui s’invite dans toutes tes conversations. Les Skills que j’utilise le plus ont tous une liste de refus explicite, nommant jusqu’aux cas voisins à écarter.

Étape 3 — Le tester des deux façons (4 minutes)

Pas besoin de redémarrer : Claude Code surveille les dossiers de Skills et prend en compte un nouveau fichier dans la session en cours.

Premier test, l’appel direct. Tape le nom, précédé d’une barre oblique :

/relecture-avant-publication

S’il apparaît dans l’autocomplétion, il est chargé. S’il n’apparaît pas, vérifie le chemin et le nom du fichier : SKILL.md, en majuscules, exactement.

Second test, le déclenchement automatique. C’est le vrai. Ouvre une nouvelle demande et formule-la sans jamais nommer le Skill :

Voici mon article, tu peux me faire une passe finale avant que je le publie ?

S’il se déclenche seul, ta description est bonne. Sinon, passe à l’étape suivante : c’est exactement le cas prévu.

Étape 4 — Le déboguer sans le réécrire (5 minutes)

Quand un Skill ne s’active pas au bon moment, ne repars pas de zéro. Demande-lui :

Dans quels cas utiliserais-tu le Skill relecture-avant-publication ? Et dans quels cas
t'abstiendrais-tu ?

La réponse te dit tout. Si l’IA hésite ou décrit des cas qui ne sont pas les tiens, ce n’est pas le Skill qui est mauvais : c’est sa description qui est trop vague. Resserre-la avec les mots que toi tu emploies réellement quand tu demandes cette tâche : « passe finale », « relis-moi ça », « c’est prêt ? ».

Deux réglages utiles quand tu ajusteras :

  • Si le Skill se déclenche trop souvent, ajoute disable-model-invocation: true dans l’en-tête. Il ne partira plus qu’à l’appel de son nom. Je le fais pour tout ce qui est structurant : basculer dans un processus lourd doit rester une décision consciente, pas une surprise.
  • S’il ne se déclenche jamais, le problème est presque toujours l’inverse d’un excès de zèle : une description écrite dans le vocabulaire de la documentation plutôt que dans le tien.

Le raccourci que j’aurais aimé connaître en premier

Tu n’es pas obligé de partir d’une page blanche. La prochaine fois qu’une conversation se termine bien (tu as trouvé la bonne méthode après quelques allers-retours), dis simplement :

Transforme cet échange en Skill réutilisable. Inclus les corrections que je t'ai demandées
en cours de route, et une section sur les cas où il ne doit PAS se déclencher.

L’IA relit ce qui vient de se passer et en tire un premier jet. Le travail que tu viens de faire une fois, tu ne le refais jamais une seconde.

Ton premier Skill existe

Un dossier, un SKILL.md, une description qui dit quand se déclencher et quand se taire. C’était la promesse, et la tâche que tu réexpliquais chaque semaine est maintenant écrite une bonne fois.

Le deuxième te prendra cinq minutes. Chez moi, la seule suite liée à mon cadre de développement en compte une quinzaine, ajoutés un par un, jamais planifiés d’avance.

En résumé

  • Un Skill = un dossier + un SKILL.md, dans ~/.claude/skills/ (personnel) ou .claude/skills/ (projet, partagé par Git).
  • La description fait tout le travail de déclenchement : ce qu’il fait, quand l’utiliser, et quand ne pas l’utiliser.
  • Teste les deux voies : /nom-du-skill pour l’appel direct, une demande formulée naturellement pour le déclenchement automatique.
  • Il ne se débogue pas en le réécrivant : demande-lui dans quels cas il s’activerait, et resserre la description avec tes mots à toi.
  • disable-model-invocation: true réserve le Skill à l’appel explicite, utile pour tout ce qui est structurant.

Toi, c’est quoi la tâche que tu viens de transformer en Skill ? Dis-le-moi en commentaire.

Le concept derrière cette mise en pratique tient en 60 secondes sur TikTok : « un Skill, ce n’est pas un prompt ». La vidéo est ici.

Cet article est la mise en pratique de Un Skill Claude, ce n’est pas un prompt sauvegardé. Abonne-toi au blog pour la suite de la série.

Similar Posts