Skip to content
Floskool

Chapter 1 · L'essentiel

Écrire ton premier skill pas à pas

Free lesson 9 minGroup Claude Code

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Tu 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

  1. Choisis une seule tâche. « Répondre aux avis Google », pas « gérer ma communication ». Un skill, une tâche.
  2. É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.
  3. Ajoute le format et les interdits. La longueur, la structure, ce qui ne doit jamais apparaître.
  4. Prévois le point d'arrêt. À quel moment il doit te montrer le résultat avant d'enregistrer, d'envoyer ou de publier.
  5. 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.