Chapter 2 · Écrire ton premier skill
Les étapes, les règles et le format de sortie
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLe pourquoi
Une bonne description fait partir le skill. Le corps décide de la qualité du résultat. Si tes étapes sont floues, Claude improvise. Si elles sont claires, tu obtiens le même niveau de qualité à chaque fois.
Exemple : Léa, gérante d'un salon de coiffure, avait écrit « fais une belle légende ». Les résultats variaient tous les jours. Elle a remplacé par des étapes numérotées, des longueurs maximales et une pause pour choisir : les légendes sont devenues régulières.
La structure qui marche
Les skills du Pack Prompts IA suivent tous à peu près le même plan. Reprends-le :
- Ton rôle : en deux phrases, qui est Claude dans ce skill et pour qui il écrit.
- Étapes : numérotées, une action par étape, dans l'ordre.
- Règles : ce qui doit toujours être vrai, et ce qui est interdit.
- Format de sortie : la forme exacte du résultat.
- Exemple : une demande type et le début de la bonne réponse.
Les cinq réflexes d'écriture
1. Des pauses pour valider
Écris noir sur blanc où Claude s'arrête : « propose 3 versions et attends mon choix ». Sans pause, il part loin dans la mauvaise direction et tu dois tout refaire.
2. Une seule question groupée
« S'il manque une information, pose UNE question groupée avec une réponse par défaut entre parenthèses. » Sinon, Claude invente ce qui manque ou te pose dix questions une par une.
3. Des règles vérifiables
« 60 mots maximum » se vérifie. « Pas trop long » ne se vérifie pas. Chaque règle doit pouvoir être cochée oui ou non.
4. Le plus important en haut
La documentation explique deux choses utiles. D'abord, le contenu du skill est ajouté à la conversation quand il est lancé, et n'est pas relu ensuite. Ensuite, quand une longue conversation est résumée pour gagner de la place, seul le début du skill peut être gardé. Donc : les règles critiques tout en haut, et des consignes qui valent pour toute la tâche (« à chaque version », « avant chaque envoi »).
5. Récupérer ce que tu tapes après le nom
Quand tu tapes /legende-instagram tarte aux fraises, le texte après le nom est transmis au skill. La documentation prévoit un mot spécial, $ARGUMENTS, que tu peux écrire dans le skill pour indiquer où ce texte doit aller. Si tu ne l'utilises pas, Claude Code ajoute quand même ta demande à la fin. Pour un premier skill, une phrase comme « lis la demande passée après le nom du skill » suffit.
Le bloc à copier : le squelette complet
---
name: [nom-du-skill]
description: [ce que fait le skill]. À utiliser quand je demande [mot 1], [mot 2], [mot 3].
---
# [Titre du skill]
## Ton rôle
Tu [rôle] pour [qui]. Tu tutoies, phrases courtes, sans jargon.
## Règles importantes
- [règle critique 1]
- N'invente aucun chiffre, prix, avis ou nom.
- Rien n'est envoyé ni publié sans mon accord.
## Étapes
1. Lis ma demande (le texte après /[nom-du-skill], ou mon dernier message).
2. S'il manque [info A] ou [info B], pose UNE question groupée avec une réponse par défaut.
3. [action]
4. Montre le résultat et attends mon accord.
5. [action finale]
## Format de sortie
- [forme : nombre de versions, longueur, titres]
## Exemple
Demande : « [exemple de demande] »
Début de réponse attendu : « [début] »
Le fil rouge : legende-instagram, version 2
---
name: legende-instagram
description: Écrit la légende d'un post Instagram pour la boulangerie (3 versions courtes, ton chaleureux, hashtags locaux). À utiliser quand je demande une légende, un texte de post, une description Instagram, ou quand j'envoie une photo de produit à publier.
---
# Légende Instagram
## Règles importantes
- Tutoiement, ton chaleureux, 2 émojis maximum par légende.
- N'invente jamais de prix, de promotion ni d'avis client.
- Tu ne publies rien : tu livres le texte, je publie.
## Étapes
1. Lis le sujet du post. S'il manque le produit ou l'occasion, pose UNE question groupée.
2. Écris 3 légendes de 60 mots maximum, numérotées.
3. Première ligne de chaque légende : une accroche de 10 mots maximum.
4. Termine chaque légende par une invitation à passer en boutique.
5. Ajoute 5 hashtags locaux sur une dernière ligne commune.
6. Attends mon choix, puis propose une variante plus courte de la version choisie.
Les erreurs à éviter
- Des étapes qui mélangent trois actions. Une étape, une action.
- Aucune pause. Ajoute au moins un « attends mon accord ».
- Des règles floues (« sois créatif »). Remplace par du mesurable.
- Un skill de trois pages. Commence court. Tu l'enrichiras avec l'usage.
À toi de jouer
- Copie le squelette et remplis-le pour ton skill.
- Ajoute au moins une pause, une question groupée et deux règles vérifiables.
- Mets ta règle la plus importante dans « Règles importantes », tout en haut.
- Enregistre, ouvre une nouvelle conversation (
/clear) et lance-le deux fois. Compare les deux résultats : ils doivent se ressembler en forme.