Le troisième chat commence à nouveau par la même explication : quels détails doivent figurer dans le briefing, quels termes l’équipe utilise-t-elle et que doit-il se passer lorsqu’il manque quelque chose ? La répétition est un bon signe que vous pouvez mettre une manière de travailler par écrit. Un skill la transforme en une instruction réutilisable que vous appliquez à bon escient et que vous continuez à entretenir.
Pour Claude Code, la documentation officielle des skills décrit un fichier SKILL.md contenant des métadonnées et des instructions. Il peut être utilisé lorsqu’une tâche s’y prête ou lorsqu’il est invoqué explicitement. Cela modifie l’instruction de travail, pas les poids entraînés du modèle. Les fichiers ci-dessous sont notre propre ébauche illustrative, et non le compte rendu d’une exécution réellement effectuée.
D’abord la décision, ensuite le fichier
Notre exemple est une soirée de réparation mensuelle. Un briefing interne doit être produit à partir de notes d’organisation. Les aides doivent y trouver les arrangements confirmés, les tâches et les décisions en suspens. C’est une mission plus restreinte que la planification de l’événement entier.
Rédigez au préalable un contrat d’entrée. Chaque détail a besoin d’une valeur et d’un statut. « Début 18:00, confirmé » est différent de « Début 18:00, suggestion ». L’IA doit préserver cette différence. Si le lieu manque, c’est une question ouverte ; une adresse de remplacement d’apparence plausible ferait échouer la mission.
Gardez le SKILL.md court et sans ambiguïté
Un emplacement possible au niveau du projet est .claude/skills/reparaturbrief/. Il pourrait contenir l’instruction de travail personnelle suivante. Les métadonnées expliquent quand elle est nécessaire ; le texte qui suit décrit ce qu’elle doit fournir.
---
name: reparaturbrief
description: Creates internal briefings for repair evenings from organisational notes.
---
Record confirmed details and suggestions separately.
Do not invent venues, dates, names or commitments.
If there are contradictions: state both details and phrase a follow-up question.
Output:
1. Confirmed arrangements
2. Tasks with confirmed responsibility
3. Open decisions with a reference to the input
4. Next coordination stepUne description telle que « aide pour tout ce qui touche à l’organisation » en dirait moins. Elle empêche de bien voir où le skill est pertinent et quand une autre manière de travailler est appropriée. Une limite claire facilite aussi la maintenance ultérieure.
Un exemple de transmission avec une vraie lacune
Utilisez des notes fictives : la salle est confirmée, l’heure de début n’est encore qu’une suggestion, et le matériel ne sera commandé qu’une fois le budget approuvé. Énoncez ces conditions directement. Un résultat attendu peut contenir une tâche « Clarifier le budget ». « Matériel commandé », en revanche, serait une affirmation nouvelle et non étayée.
Une instruction supplémentaire utile est la suivante : « Pour chaque décision en suspens, indiquez quelle partie de l’entrée la déclenche. » Cela crée un lien entre la lacune et sa source. Le skill n’a pas à répéter l’intégralité du texte original ; il doit permettre de retrouver facilement le détail litigieux.
Séparez une préférence stylistique des règles de fond. Un exemple de descriptions de tâches courtes peut servir de fichier d’appui. Les détails de l’événement qui changent fréquemment relèvent en revanche de la mission individuelle. Ainsi, l’instruction générale ne devient pas obsolète à la date suivante.
Trois cas révèlent des faiblesses différentes
Dans le premier cas, vous fournissez des détails complets et cohérents. Dans le deuxième, la date manque et deux notes budgétaires se contredisent. Dans le troisième, vous demandez quelque chose qui sort du domaine du skill, comme la planification d’un voyage. Cela vous permet d’examiner séparément la structure, le traitement de l’incertitude et les limites d’utilisation.
Pour chaque cas, notez ce qui doit absolument être préservé. Jugez une réponse d’abord à cette aune, et seulement ensuite à son style. Une formulation élégante ne compense pas une date inventée. De même, une question de suivi n’est pas une erreur si c’est précisément cette décision qui manque dans l’entrée.
Entretenir une petite instruction de travail
Lorsqu’un problème se reproduit, modifiez une règle précise et répétez les cas existants. Ajoutez un nouveau cas qui n’était pas encore connu au moment où la modification a été rédigée. Il est ainsi plus facile de voir si la règle ne fait que reproduire un exemple isolé.
Consignez la raison de la modification et son statut. Au début, cela ne nécessite aucune infrastructure importante. Une courte note telle que « Les conditions budgétaires doivent être préservées dans la liste de tâches » est plus facile à suivre qu’une réécriture complète sans justification. Un skill en vaut la peine lorsque ses règles rendent la prochaine transmission réelle plus facile à comprendre.
Sources et état de la documentation : 25 octobre 2026.
