Créer son premier Skill Claude : exemple complet et méthode de test

Ce qu’un Skill apporte, et quand un simple prompt suffit

Un prompt suffit pour une tâche isolée dont les consignes tiennent en quelques lignes. Un Skill devient intéressant lorsque vous répétez la même procédure, utilisez un format de sortie stable ou devez transmettre une méthode à plusieurs personnes. La documentation Claude Code sur les Skills décrit le fichier SKILL.md et les mécanismes d’invocation. La spécification Agent Skills définit le format partagé.

Évitez de commencer par « un Skill qui gère mon entreprise ». Cette formulation n’indique ni l’entrée attendue ni les limites. Notre exemple reçoit des notes, extrait ce qui est explicitement présent et prépare une liste d’actions. Il n’envoie pas de mail, ne crée pas de rendez-vous et ne modifie aucun CRM. Ces opérations seraient des étapes séparées, avec leurs propres règles.

Définir un contrat d’entrée et de sortie

Écrivez d’abord ce que le Skill accepte : notes libres, transcription ou compte rendu existant. Précisez la date de la réunion, les participants connus et les décisions à conserver. Si une donnée manque, le Skill doit écrire « non précisé » plutôt que compléter la conversation de manière plausible.

La sortie attendue contient quatre rubriques : synthèse, décisions, tableau d’actions et questions ouvertes. Dans le tableau, chaque action comporte un responsable, une échéance et une preuve issue des notes. Une action sans responsable reste une action à clarifier. Une phrase comme « nous pourrions contacter le fournisseur » ne devient pas automatiquement une décision validée.

Cette séparation évite un problème fréquent : un compte rendu fluide qui paraît plus définitif que la réunion elle-même. Le critère principal sera donc la fidélité, avant l’élégance de rédaction.

Créer le fichier SKILL.md

Pour Claude Code, placez le fichier dans un dossier de Skill adapté à votre projet. Vérifiez le chemin et les champs supportés dans la documentation de votre version. Le modèle utilise un nom explicite et une description qui indique le déclencheur.

---
name: compte-rendu-reunion
description: Transformer des notes de réunion en décisions et actions sourcées. Utiliser lorsque l'utilisateur fournit des notes à structurer.
---

# Compte rendu de réunion

1. Lire les notes et identifier la date et les participants.
2. Séparer faits, décisions, propositions et questions ouvertes.
3. Extraire les actions explicitement demandées.
4. Ne jamais inventer un responsable ou une échéance.
5. Produire une synthèse puis un tableau d'actions.
6. Citer la phrase source pour chaque décision et action.
7. Signaler les contradictions et informations manquantes.

Ne pas envoyer le compte rendu et ne pas modifier d'autre outil.

Le corps du fichier doit être compréhensible par une autre personne. Si vous ne pouvez pas expliquer une règle, simplifiez-la. Ajoutez un document de référence seulement lorsqu’il apporte une contrainte utile, par exemple le format de compte rendu de votre équipe.

Tester avec une réunion fictive

Utilisez ces notes : « Réunion du 12 octobre. Maya préparera une estimation vendredi. Lucas propose de tester deux fournisseurs. Aucun choix n’a été fait. Il faut confirmer qui appellera les fournisseurs. »

Le résultat correct comporte une action pour Maya, une proposition de Lucas et une question sur le responsable des appels. Il ne doit pas annoncer que Lucas contactera les fournisseurs. Si l’année, le contexte calendaire ou la date exacte du vendredi ne sont pas suffisamment établis, l’échéance doit conserver le libellé original et demander confirmation.

Refaites ensuite le test avec une note contradictoire : « Maya ne peut finalement pas préparer l’estimation ». Le Skill devrait faire ressortir cette contradiction, pas choisir discrètement la phrase la plus récente sans l’expliquer. Enfin, essayez des notes vides : la bonne réponse consiste à demander les informations nécessaires.

Structure les notes ci-dessous en synthèse, décisions, actions et questions ouvertes. Pour chaque action, cite la phrase source. N'invente aucun responsable ni aucune échéance. Signale les propositions non validées et les contradictions.

Évaluer la qualité avant de réutiliser le Skill

Conservez un petit jeu de tests avec trois situations : réunion simple, réunion ambiguë et notes incomplètes. Pour chaque situation, écrivez les éléments obligatoires et les inventions interdites. Ce jeu devient votre référence lorsque vous modifiez les instructions ou changez de modèle.

Évaluez chaque sortie selon quatre critères : actions retrouvées, informations inventées, contradictions signalées et conformité au format. Un résultat peut être bien rédigé et échouer au deuxième critère. Il doit alors être corrigé avant réutilisation. Notez les erreurs et modifiez une règle à la fois pour comprendre l’effet de votre changement.

Passer du prototype à une méthode d’équipe

Versionnez le Skill avec son jeu de tests. Conservez une courte note de changement : règle ajoutée, problème corrigé et date du test. Identifiez la personne responsable de la maintenance. Un Skill partagé mais jamais revu peut continuer à produire un format devenu inutile.

Pour une utilisation professionnelle, vérifiez que les notes peuvent être transmises à l’outil choisi. Commencez avec des informations fictives ou anonymisées. Un dossier de référence doit contenir uniquement ce qui est nécessaire. Les bonnes pratiques de Claude Code recommandent notamment de donner à l’assistant un moyen de vérifier son travail.

Vérifiez votre compréhension

Ressource et étape suivante

Télécharger le modèle de premier Skill. Pour comprendre les variantes et la maintenance, poursuivez avec notre guide complet des Skills et le parcours Context Engineering.

Questions fréquentes

Faut-il coder ? La procédure de ce tutoriel est textuelle. Des scripts peuvent être ajoutés plus tard pour des opérations déterministes, mais ils ne sont pas nécessaires à cet exercice.

Peut-on garantir une sortie identique ? Non. Testez les critères de fidélité et de structure, plutôt que l’identité exacte de chaque phrase.

Comment savoir si le Skill reste utile ? Mesurez les erreurs restantes et le temps de relecture sur vos tâches réelles, sans extrapoler un gain à partir d’un seul essai.

Sources

• →Claude Code : Skills.
• →Agent Skills : spécification du format.
• →Claude Code : bonnes pratiques de vérification.