Chapter 1 · L'essentiel
Écrire ton premier skill pas à pas
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeTu connais l'anatomie d'un SKILL.md. Voici la méthode pour écrire le tien, puis deux skills complets à copier tels quels et à adapter.
La méthode en 5 étapes
- Choisis une seule tâche. « Répondre aux avis Google », pas « gérer ma communication ». Un skill, une tâche.
- Écris ta méthode comme tu la ferais. Ouvre un fichier texte et décris, étape par étape, ce que tu fais vraiment. Garde tes mots.
- Ajoute le format et les interdits. La longueur, la structure, ce qui ne doit jamais apparaître.
- Prévois le point d'arrêt. À quel moment il doit te montrer le résultat avant d'enregistrer, d'envoyer ou de publier.
- Rédige la description en dernier. Ce que fait le skill, puis « À utiliser quand... » avec les mots que tu emploies.
Ensuite, range le fichier dans son dossier (~/.claude/skills/<nom>/SKILL.md), tape /skills pour vérifier qu'il apparaît, et teste-le sur un vrai cas.
Exemple 1 : répondre aux avis Google
À enregistrer dans ~/.claude/skills/reponse-avis/SKILL.md :
---
name: reponse-avis
description: Rédige la réponse à un avis Google laissé par un client. À utiliser quand je colle un avis, ou que je demande de répondre à un avis ou à un commentaire client.
---
# Réponse aux avis Google
## Ton rôle
Tu rédiges une réponse publique à un avis, au nom de mon commerce. Tu tutoies seulement si le client a tutoyé. Ton chaleureux, simple, sans formule toute faite.
## Étapes
1. Remercie la personne par son prénom (s'il apparaît dans l'avis).
2. Reprends un détail précis de son avis, pour montrer que tu l'as lu.
3. Avis positif : dis ce que ça te fait, invite-la à revenir.
4. Avis négatif : reconnais le problème sans te justifier longuement, excuse-toi si c'est mérité, et propose d'en parler par téléphone au [ton numéro] ou par e-mail.
5. Termine par ton prénom : [ton prénom].
## Format
- Quatre phrases maximum.
- Pas d'emoji, pas de point d'exclamation en série.
- Propose deux versions : une courte, une un peu plus chaleureuse.
## Interdits
- Jamais de promesse que je n'ai pas faite (remboursement, geste commercial).
- Jamais de détail personnel sur le client (commande, adresse, santé).
- Ne publie rien : montre-moi les deux versions et attends mon choix.
Pourquoi il marche : la description reprend les mots que tu tapes vraiment (« avis », « commentaire client »), donc il se déclenche tout seul quand tu colles un avis. Les interdits protègent ta réputation : pas de promesse en ton nom, pas de donnée personnelle en public. Et les deux versions te laissent le dernier mot.
Exemple 2 : préparer un devis
À enregistrer dans ~/.claude/skills/devis/SKILL.md, avec tes tarifs dans un fichier tarifs.md à la racine de ton dossier de travail :
---
name: devis
description: Prépare un devis à partir de mes tarifs. À utiliser quand je demande un devis, une estimation ou un chiffrage pour un client.
disable-model-invocation: true
---
# Préparation d'un devis
## Ton rôle
Tu prépares un devis clair, à partir de mes tarifs et de la demande du client. Tu ne fixes jamais un prix toi-même.
## Étapes
1. Lis tarifs.md. S'il n'existe pas, arrête-toi et demande-le-moi.
2. Résume la demande du client en 3 lignes et pose-moi au maximum 3 questions s'il manque une information (quantités, délais, options).
3. Liste chaque prestation avec le prix de tarifs.md. Si une prestation n'y figure pas, écris [prix à compléter].
4. Ajoute les mentions que j'ai listées dans mentions-devis.md (TVA, acompte, durée de validité, conditions de paiement).
5. Calcule les totaux et vérifie chaque calcul une seconde fois.
## Format
- Un fichier devis-AAAA-MM-JJ-nom-du-client.md dans le dossier devis/.
- En haut : mes coordonnées, celles du client, la date, le numéro du devis.
- Un tableau : prestation, quantité, prix unitaire, total.
## Interdits
- Aucun prix inventé : seulement ceux de tarifs.md, ou [prix à compléter].
- Aucune remise sans ma demande.
- Montre-moi le devis complet avant de créer le fichier, et n'envoie rien au client.
Pourquoi il marche : le skill ne connaît aucun prix, il les lit dans ton fichier. Tu changes tes tarifs une fois dans tarifs.md, et tous les devis suivent. La ligne disable-model-invocation: true évite qu'il se lance sans que tu l'appelles : un devis, ça se demande exprès, avec /devis cuisine M. Martin. Et les mentions viennent de ton propre fichier : vérifie-les une fois avec ton comptable ou les sources officielles, elles seront justes à chaque devis.
Le test qui compte
Un skill se juge sur un vrai cas, pas sur sa relecture. Lance-le avec un avis réel ou une vraie demande de devis, compare avec ce que tu aurais fait toi-même, et note chaque écart. Chaque écart devient une ligne de plus dans le SKILL.md.
Dans la leçon suivante, tu trouveras 6 prompts prêts à copier pour faire créer, tester et améliorer tes skills par Claude Code lui-même.