Ton premier Skill perso, écrit ligne par ligne : la synthèse de réunion

À la fin de cet article, tu auras écrit un SKILL.md toi-même, sans plugin, pour une tâche que la plupart des praticiens IA refont chaque semaine : mettre en forme les notes d’une réunion. Quinze minutes, et tu sauras exactement ce que fait chaque ligne du fichier.

L’article précédent t’a fait installer skill-creator, le plugin qui pose des questions puis écrit un SKILL.md à ta place. C’était pratique, mais ça laisse une zone d’ombre : tu as accepté un fichier généré sans avoir décidé toi-même de son contenu, ligne par ligne. Une compétence (Skill), c’est un dossier d’instructions que tu donnes à Claude Code pour qu’il sache exactement comment faire une tâche précise, un peu comme une procédure écrite que tu laisserais à un collègue pour qu’il refasse la tâche à ta place. Ici, on répare ça avec un exemple différent de la relecture avant publication vue dans la série précédente : la synthèse de réunion.

Ce qu’il te faut

Claude Code installé, et des notes de réunion sous la main, même brouillonnes. Un compte-rendu à moitié rédigé, une transcription automatique, ou tes propres griffonnages : tout convient, c’est justement ce que le Skill doit apprendre à digérer.

Étape 1 — Répondre soi-même aux quatre questions que poserait skill-creator (5 minutes)

skill-creator pose toujours les quatre mêmes questions avant d’écrire quoi que ce soit : à quoi sert le Skill, quand doit-il se déclencher, à quoi doit ressembler le résultat, et comment le tester. Cette fois, réponds-y toi-même, sur papier ou dans un fichier texte, avant de toucher au SKILL.md :

• Intention : transformer des notes de réunion, quel que soit leur état, en un compte-rendu structuré.
• Déclenchement : quand je fournis des notes de réunion et que je demande un résumé, un compte-rendu, ou que je dis « mets ça au propre ».
• Format de sortie : quatre sections fixes, dans cet ordre : décisions prises, actions à suivre (avec responsable si mentionné), points en suspens, prochaine échéance si elle a été fixée.
• Contre-exemple : ne surtout pas se déclencher sur un résumé d’article, de vidéo, ou de conversation qui n’est pas une réunion.

Ce dernier point est celui que la génération automatique oublie le plus souvent, comme je le notais dans l’article sur skill-creator. Ici, tu le poses en premier, avant même d’écrire une ligne de Markdown (le langage de mise en forme simple utilisé pour écrire les fichiers SKILL.md).

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

# macOS, Linux, ou Git Bash sous Windows
mkdir -p ~/.claude/skills/synthese-reunion

# PowerShell (Windows)
New-Item -ItemType Directory -Force ~.claudeskillssynthese-reunion

Un Skill personnel, disponible dans tous tes projets. Si tu veux le partager avec ton équipe via Git, remplace ~/.claude/skills/ par .claude/skills/ à la racine du dépôt.

Étape 3 — Écrire le SKILL.md à partir de tes quatre réponses (6 minutes)

Le fichier traduit directement ce que tu as répondu à l’étape 1. La description, dans l’en-tête de métadonnées (frontmatter) tout en haut du fichier, porte l’intention, le déclenchement et le contre-exemple :

---
description: Transforme des notes de réunion (brouillon, transcription, notes manuscrites
  retranscrites) en compte-rendu structuré. À utiliser quand l'utilisateur fournit des notes
  de réunion et demande un résumé, un compte-rendu, ou de « mettre ça au propre ».
  Ne pas utiliser pour résumer un article, une vidéo, ou une conversation qui n'est pas
  une réunion.
---

## Ta tâche

À partir des notes fournies, produis un compte-rendu en quatre sections, dans cet ordre :

1. **Décisions prises** : chaque décision actée pendant la réunion, une ligne par décision.
2. **Actions à suivre** : chaque tâche identifiée, avec le nom du responsable si les notes
   le mentionnent, sinon écris "responsable non précisé".
3. **Points en suspens** : les sujets évoqués mais non tranchés.
4. **Prochaine échéance** : la date du prochain point si elle a été fixée, sinon écris
   "aucune date fixée".

Si une section n'a aucun élément, écris "aucun" plutôt que de l'omettre. Ne reformule pas
les décisions au point de leur faire dire autre chose que ce que les notes indiquent.

Remarque la dernière phrase du corps : elle n’était dans aucune des quatre questions de skill-creator, elle vient de ce que tu sais, toi, sur ce que « résumer » veut dire pour tes notes de réunion à toi. C’est exactement ce que gagne un SKILL.md écrit à la main : les détails que tu ajoutes sans qu’on te les ait demandés, parce que tu connais le piège avant qu’il arrive.

Étape 4 — Tester les trois cas, pas juste les deux habituels (3 minutes)

Les deux tests classiques d’abord :

/synthese-reunion

Puis, sans nommer le Skill :

Voici mes notes de la réunion de ce matin, tu peux me faire un compte-rendu ?

S’il se déclenche dans les deux cas, ta description tient la route. Ajoute un troisième test, celui que la génération automatique oublie : vérifie que le Skill ne se déclenche pas là où il ne doit pas.

Tu peux me résumer cet article ?

Si le Skill de synthèse de réunion se déclenche ici, ta description n’est pas assez précise : elle capte le mot « résumer » au lieu de capter « réunion ». Resserre-la en répétant le mot « réunion » dans la phrase de déclenchement, plutôt que de généraliser sur « résumer » ou « mettre au propre ».

Ce que la version manuscrite t’a appris que la version générée ne t’aurait pas appris

Avec skill-creator, tu acceptes un brouillon et tu le corriges après coup. Ici, tu as écrit le contre-exemple avant la description, tu as choisi les quatre sections du compte-rendu toi-même, et tu as ajouté une consigne sur la fidélité au texte source qu’aucune interview ne t’aurait posée comme question. Le résultat final peut ressembler à ce que skill-creator aurait généré. La différence est que tu sais pourquoi chaque ligne est là, et donc comment la corriger dans six mois quand tes réunions changeront de format.

Ce qui vient de se passer

Un deuxième Skill personnel existe maintenant, ~/.claude/skills/synthese-reunion/, écrit sans plugin, testé sur ses deux déclenchements attendus et sur un contre-exemple qui doit rester silencieux. Le réflexe que tu avais avec skill-creator, celui de répondre aux quatre questions avant d’écrire, tu viens de le refaire seul, à la main.

En résumé

• Réponds toi-même aux quatre questions de skill-creator (intention, déclenchement, format de sortie, contre-exemple) avant d’écrire le SKILL.md, en commençant par le contre-exemple.
• Le fichier se crée dans ~/.claude/skills/<nom>/SKILL.md (personnel) ou .claude/skills/<nom>/SKILL.md (projet, partagé par Git).
• Teste trois cas, pas deux : l’appel direct (/nom-du-skill), le déclenchement naturel, et un contre-exemple qui doit rester silencieux.
• Une description trop générale (« résumer », « mettre au propre ») capte des demandes qui n’ont rien à voir avec ta tâche : nomme le mot précis qui doit la déclencher.
• Écrire à la main prend plus de temps que l’interview, mais tu sais pourquoi chaque ligne existe, donc comment la corriger plus tard.

Prochaine étape : pourquoi le même Skill se déclenche parfois trop souvent, parfois jamais, et comment le diagnostiquer sans le réécrire à chaque fois.

---

Cette mise en pratique poursuit la série sur l’installation et la configuration de Claude Code, de zéro jusqu’à un premier programme fonctionnel. La vidéo est ici.

Abonne-toi au blog pour suivre la suite de la série.