Aller au contenu
Floskool

Chapitre 3 · Rendre ton skill fiable

Les erreurs fréquentes, et faire écrire un skill par Claude Code

Leçon gratuite 9 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Le pourquoi

Les mêmes pannes reviennent chez presque tout le monde. Les connaître te fait gagner des heures. Et une fois que tu sais à quoi ressemble un bon skill, tu peux laisser Claude Code l'écrire pour toi : c'est souvent le plus rapide.

Exemple : Nadia, comptable indépendante, a écrit son skill de relance en vingt minutes. Il ne se lançait jamais. La cause : une ligne vide avant le premier ---. Deux secondes pour corriger, une fois qu'on sait.

Les erreurs fréquentes et leur solution

Le skill n'apparaît pas dans /skills

  • Le fichier n'est pas dans un sous-dossier : il faut skills/[nom]/SKILL.md.
  • Le fichier s'appelle skill.md, Skill.md ou SKILL.md.txt.
  • Le dossier skills a été créé pendant la conversation : tape /reload-skills, ou relance Claude Code.
  • Le nom contient des caractères refusés. Garde minuscules, chiffres et tirets.

Il apparaît, mais ne se lance jamais tout seul

La documentation conseille :

  • vérifier que la description contient les mots que tu emploies vraiment ;
  • reformuler ta demande pour te rapprocher de la description ;
  • le lancer directement avec /nom.

Elle précise aussi un piège : si l'en-tête est mal écrit, le skill se charge sans ses informations. /nom marche encore, mais Claude ne peut plus le choisir tout seul faute de description. Vérifie les deux lignes ---, et que name: et description: sont bien écrits, avec les deux-points.

Il se lance trop souvent

Rends la description plus précise. Et si le skill ne doit partir qu'à ta demande, ajoute disable-model-invocation: true dans l'en-tête.

Claude suit le skill au début, puis l'oublie

D'après la documentation : relance le skill (/nom) après une longue conversation, mets les règles importantes en haut du fichier, et formule-les pour toute la tâche (« à chaque version », pas « dans la version »). Pour une règle qui doit tenir à chaque fois sans exception, la documentation renvoie vers les hooks (des actions automatiques déclenchées par Claude Code) : c'est un sujet plus avancé, à voir dans la documentation.

Le résultat est correct mais pas « toi »

Ajoute un fichier exemples.md (leçon 6) et une ligne « Ton rôle » plus précise : à qui tu parles, comment.

Faire écrire un skill par Claude Code

Méthode 1 : à partir d'une tâche réussie

C'est la méthode la plus fiable : tu viens de réussir une tâche avec Claude, tu lui demandes d'en faire un skill. Le skill part de ce qui a marché, pas d'une théorie.

Contexte : dans cette conversation, on vient de réussir [la tâche, ex. écrire la relance de mon client] et je vais refaire cette tâche chaque semaine.
Objectif : transformer ce qu'on a fait en skill réutilisable, dans .claude/skills/[nom-du-skill]/SKILL.md de ce projet.
Contraintes :
- Nom en minuscules avec des tirets.
- Une description qui dit ce que fait le skill ET quand l'utiliser, avec mes mots.
- Sections : Ton rôle, Règles importantes, Étapes numérotées, Format de sortie, Exemple.
- Au moins une pause où tu attends mon accord.
- Aucune clé, aucun mot de passe, aucun chemin propre à mon ordinateur.
- N'invente aucun chiffre, prix ou avis.
Format attendu : le contenu complet du SKILL.md dans un bloc, puis 3 phrases qui devraient le lancer et 2 qui ne devraient pas.
Validation : attends mon accord avant d'écrire le fichier. Ensuite, dis-moi comment le tester avec /skills puis /[nom-du-skill].

Méthode 2 : par interview

Tu pars de zéro ? Fais-toi interroger :

Je veux créer un skill Claude Code pour [ma tâche].
Pose-moi les questions une par une (6 au maximum) : le résultat attendu, le ton, les règles, les interdits, les moments où tu dois t'arrêter pour mon accord, les mots que j'emploie pour demander cette tâche.
Ensuite, rédige le SKILL.md complet (en-tête avec name et description, puis Ton rôle, Règles importantes, Étapes, Format de sortie, Exemple).
Montre-le-moi et n'écris le fichier .claude/skills/[nom]/SKILL.md qu'après mon accord.

Relis toujours ce que Claude écrit

Même écrit par Claude, un skill reste tes consignes. Relis-le ligne par ligne : chaque règle te ressemble-t-elle ? Une étape est-elle inutile ? Supprime sans hésiter.

Les erreurs à éviter

  • Accepter le premier jet sans le lire. Tu valides un fichier que Claude suivra des centaines de fois.
  • Un skill écrit par Claude trop long. Demande : « réduis à l'essentiel, garde seulement ce qui change le résultat ».
  • Copier un skill trouvé en ligne sans l'ouvrir. Un skill peut contenir des scripts que Claude exécutera. Ouvre chaque fichier du dossier. Cherche ce qui supprime, envoie des données ou lit tes clés (.env). Dans le doute, ne l'installe pas.

À toi de jouer

  1. Fais une tâche répétitive avec Claude Code jusqu'à un résultat qui te plaît.
  2. Lance la méthode 1 dans la même conversation.
  3. Relis le skill proposé, corrige deux lignes, valide.
  4. Tape /skills, puis teste-le dans une nouvelle conversation avec ta série de tests de la leçon 6.