Skip to content
Floskool

Chapter 2 · Écrire ton premier skill

Créer le dossier et le fichier au bon endroit

Free lesson 9 minGroup Claude Code & IA

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

Follow for free

Le 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/

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

  1. Ouvre l'Explorateur de fichiers.
  2. Dans la barre d'adresse, tape %USERPROFILE%\.claude puis Entrée. Si le dossier n'existe pas, va dans %USERPROFILE% et crée un dossier nommé exactement .claude (avec le point).
  3. Crée un dossier skills (tout en minuscules) s'il n'existe pas.
  4. Dedans, crée un dossier legende-instagram.
  5. Ouvre le Bloc-notes, colle le contenu du skill, puis « Enregistrer sous » : nom SKILL.md, type « Tous les fichiers ».

Sur Mac

  1. Dans le Finder, menu Aller, puis « Aller au dossier » (Cmd+Maj+G).
  2. Tape ~/.claude puis 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 tape mkdir -p ~/.claude/skills.
  3. Crée le dossier legende-instagram dans skills.
  4. 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, pas Légende Instagram.
  • Un dossier par skill, à l'intérieur de skills.

Vérifier qu'il est reconnu

  1. Dans Claude Code, tape /skills : la liste de tes skills s'affiche. Le tien doit y être.
  2. 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 dossier skills n'existait pas au lancement de la conversation, cette commande est nécessaire.
  3. Toujours rien ? Ferme Claude Code (/exit) et relance-le.
  4. Puis teste : /legende-instagram nouveau bouquet de pivoines.

Les erreurs à éviter

  • Le fichier posé directement dans skills/, sans son dossier. Il faut skills/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

  1. 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.
  2. Tape /skills et vérifie qu'il apparaît.
  3. 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.