Chapter 2 · Écrire ton premier skill
Créer le dossier et le fichier au bon endroit
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLe pourquoi
Un skill mal rangé ne marche pas. Pas d'erreur, pas de message : il n'apparaît simplement pas. C'est la panne la plus courante au début, et elle se règle en deux minutes quand on sait où regarder.
Exemple : Sophie, photographe, crée son fichier SKILL.md directement dans skills/, sans sous-dossier. Claude Code ne le voit pas. Elle le déplace dans skills/reponse-client/SKILL.md : il apparaît.
Les deux emplacements
D'après la documentation officielle et le guide du pack :
- Pour un seul projet :
.claude/skills/[nom-du-skill]/SKILL.md, à l'intérieur du dossier du projet. Pratique si tu partages ce projet avec quelqu'un : le skill voyage avec. - Pour tous tes projets :
~/.claude/skills/[nom-du-skill]/SKILL.md. Le signe~désigne ton dossier utilisateur :- Windows :
C:\Users\[ton nom]\.claude\skills\ - Mac :
/Users/[ton nom]/.claude/skills/
- Windows :
Si un skill porte le même nom aux deux endroits, la documentation indique que le skill personnel passe avant celui du projet.
Un point de détail : la documentation précise que les sessions Claude Code dans le cloud ne lisent pas ~/.claude/skills/ de ton ordinateur. Si tu travailles surtout sur ton ordinateur, ça ne te concerne pas.
Le comment, à la main
Sur Windows
- Ouvre l'Explorateur de fichiers.
- Dans la barre d'adresse, tape
%USERPROFILE%\.claudepuis Entrée. Si le dossier n'existe pas, va dans%USERPROFILE%et crée un dossier nommé exactement.claude(avec le point). - Crée un dossier
skills(tout en minuscules) s'il n'existe pas. - Dedans, crée un dossier
legende-instagram. - Ouvre le Bloc-notes, colle le contenu du skill, puis « Enregistrer sous » : nom
SKILL.md, type « Tous les fichiers ».
Sur Mac
- Dans le Finder, menu Aller, puis « Aller au dossier » (
Cmd+Maj+G). - Tape
~/.claudepuis Entrée. Les dossiers qui commencent par un point sont cachés : ce raccourci permet d'y aller quand même. S'il est introuvable, ouvre le Terminal et tapemkdir -p ~/.claude/skills. - Crée le dossier
legende-instagramdansskills. - Dans TextEdit, passe en texte brut (menu Format), colle le contenu, enregistre sous
SKILL.md.
Le comment, en un prompt (plus simple)
Laisse Claude Code créer le dossier pour toi. Lance-le dans ton projet et colle :
Contexte : je crée mon premier skill Claude Code.
Objectif : créer le fichier .claude/skills/legende-instagram/SKILL.md dans ce projet.
Contenu : le bloc ci-dessous, tel quel.
Contraintes : crée les dossiers manquants. Ne touche à aucun autre fichier.
Validation : montre-moi le chemin complet avant d'écrire et attends mon accord.
---
name: legende-instagram
description: Écrit la légende d'un post Instagram pour la boutique. À utiliser quand je demande une légende, un texte de post ou une description pour Instagram.
---
1. Demande-moi le sujet du post si je ne l'ai pas donné.
2. Propose 3 légendes de 60 mots maximum, numérotées.
3. Tutoiement, 2 émojis maximum, 5 hashtags locaux à la fin.
4. N'invente jamais de prix ni d'avis client.
Pour l'installer pour tous tes projets, remplace le chemin par ~/.claude/skills/legende-instagram/SKILL.md. Claude Code te demandera l'autorisation d'écrire hors de ton projet : accepte pour cette opération.
Les règles de forme
- Le fichier s'appelle exactement
SKILL.md, en majuscules. - La toute première ligne du fichier est
---. La documentation précise que si l'en-tête n'est pas en première ligne, ses champs ne sont pas pris en compte. - Le nom : minuscules, chiffres et tirets. Pas d'espace, pas d'accent :
legende-instagram, pasLégende Instagram. - Un dossier par skill, à l'intérieur de
skills.
Vérifier qu'il est reconnu
- Dans Claude Code, tape
/skills: la liste de tes skills s'affiche. Le tien doit y être. - Il manque ? Tape
/reload-skills. D'après la documentation, Claude Code repère d'habitude les skills ajoutés ou modifiés sans redémarrer, mais si le dossierskillsn'existait pas au lancement de la conversation, cette commande est nécessaire. - Toujours rien ? Ferme Claude Code (
/exit) et relance-le. - Puis teste :
/legende-instagram nouveau bouquet de pivoines.
Les erreurs à éviter
- Le fichier posé directement dans
skills/, sans son dossier. Il fautskills/legende-instagram/SKILL.md. - Le fichier
SKILL.md.txt. Sur Windows, le Bloc-notes ajoute parfois.txt. Active l'affichage des extensions dans l'Explorateur (menu Affichage) pour vérifier. - Une ligne vide ou un espace avant le premier
---. - Un nom avec espaces ou majuscules. Garde des minuscules et des tirets.
À toi de jouer
- Crée ton skill
legende-instagram(ou le skill choisi en leçon 1) dans.claude/skills/de ton projet, à la main ou avec le prompt. - Tape
/skillset vérifie qu'il apparaît. - Lance-le une fois avec
/et une fois sans, en écrivant « écris-moi une légende Instagram pour [ton sujet] ». Note s'il s'est lancé tout seul. On améliore ça à la leçon suivante.