Guide · les outils

Écrire ton premier skill, taillé pour ton travail.

Un skill générique parle à tout le monde, donc à personne. Un skill qui connaît tes documents, ton vocabulaire et tes contraintes vaut dix prompts malins gardés dans un fichier texte.

Ce qu'est un skill, où il se range exactement, le prompt qui le fait écrire par Claude, puis le seul détail qui décide s'il se déclenche ou dort pour toujours.

Tu débutes vraiment ? Commence iciL'app Claude ou Claude Code ? Ce n'est pas la même chose→

Avant tout : la différence avec un prompt

Un prompt, tu le recolles à chaque fois. Un skill, Claude le charge tout seul quand la tâche correspond. C'est toute la différence. Et elle est énorme sur une semaine de travail.

Concrètement, un skill est un simple dossier contenant un fichier texte. Rien à compiler, rien à installer.

$ ls ~/.claude/skills/
→ un dossier par skill, chacun avec un SKILL.md dedans

Le piège

Confondre un skill avec le fichier de règles du projet. Le CLAUDE.md est lu à chaque session, un skill seulement quand il sert. Ce qui vaut toujours va dans le premier, ce qui vaut parfois dans le second.

Choisir la bonne tâche à automatiser

Le premier skill rate presque toujours pour la même raison : la tâche choisie est trop large. « M'aider à écrire » ne se déclenchera jamais au bon moment parce que ça ne veut rien dire de précis.

La bonne tâche remplit trois conditions. Tu la refais au moins une fois par semaine. Tu la fais toujours de la même façon. Et tu as déjà deux ou trois exemples de ce que ça doit donner.

Mauvais candidat	Bon candidat
Aide à la rédaction	Rédiger le compte rendu d'une réunion client au format de mon cabinet
Améliorer mon code	Écrire les tests d'un module Python selon nos conventions
Répondre aux mails	Répondre à une demande de devis avec ma grille tarifaire

Le piège

Choisir une tâche que tu fais deux fois par an. Le temps d'écrire le skill dépasse le temps gagné, puis tu auras oublié qu'il existe.

Le faire écrire par Claude

Écrire un skill à la main est une perte de temps. Décris la tâche, joins de vrais exemples, laisse-le poser ses questions.

Cree-moi un skill pour une tache que je refais tout le temps :
[decris-la en deux phrases].

Pose-moi les questions dont tu as besoin AVANT d'ecrire quoi
que ce soit. Je te joins deux exemples de ce que j'ai deja
produit, pour que le resultat sonne comme moi.

Quand tu auras assez d'informations, ecris le skill et donne-lui
une description qui dit precisement dans quels cas il doit se
declencher.

Bon à savoir

Les vrais exemples font toute la différence. Un skill écrit sans eux produit du texte correct et impersonnel. Avec eux, il produit quelque chose qui te ressemble.

Le piège

Le laisser écrire tout de suite sans te poser de questions. S'il part directement, c'est qu'il comble les trous par des suppositions. Coupe-le et redemande les questions.

La description, qui décide de tout

C'est de loin la ligne la plus importante du fichier. Elle seule décide si le skill se déclenche. Une description vague donne un skill qui ne part jamais, puis tu conclus à tort qu'il ne marche pas.

---
name: compte-rendu-client
description: aide a la redaction    <- ne partira jamais
description: redige le compte rendu d'une reunion client au
  format du cabinet, a partir de notes brutes ou d'une
  transcription
---

Où ça

Dans l'en-tête de ~/.claude/skills/<nom>/SKILL.md, entre les deux lignes de tirets.

La règle : écris la description comme si tu expliquais à un collègue quand il doit t'appeler. Les mots que tu emploierais pour décrire la situation sont exactement ceux qui doivent y figurer.

Le piège

Écrire la description au futur ou à l'impératif, du genre « à utiliser pour ». Décris la situation, pas l'instruction. C'est la situation qu'il doit reconnaître.

Vérifier qu'il se déclenche vraiment

Ne suppose jamais. Ouvre une session neuve, formule ta demande comme tu le ferais un jour normal, puis regarde s'il l'utilise.

$ claude
→ puis, sans mentionner le skill :
> voila mes notes de la reunion avec Dupont, fais le compte rendu

Bon à savoir

S'il ne le charge pas tout seul, le problème est dans la description, jamais dans le corps du skill. Réécris-la avec les mots que tu viens d'employer dans ta demande.

Le piège

Tester en écrivant « utilise le skill compte-rendu ». Ça marche à tous les coups et ça ne prouve rien : tu as fait le travail de déclenchement à sa place.

Premium

Ton premier projet en ligne, de bout en bout

Du dossier vide à une adresse que tu peux envoyer
Le nom de domaine, l'hébergement, la mise en ligne
Les six endroits où ça casse, puis quoi taper quand ça casse

Voir ce qu'il y a dedans →

Si tu ne retiens qu'une chose

La description, rien d'autre. Un skill médiocre avec une bonne description te servira toutes les semaines. Un skill parfait avec une description vague dormira pour toujours dans un dossier que tu ne rouvriras jamais.

Le guide qui va avecLes trois niveaux de CLAUDE.md. Lequel écrire en premier.→

Un guide par semaine, tous ouverts.

Sans e-mail à donner. La formation complète ouvre bientôt à 39 € par mois ou 199 € l'année. Les inscrits ont l'accès en premier et gardent ce tarif.

Accès anticipé