Maîtriser Claude Code — De zéro à 10x — 3. Ton premier skill : /post

18 min read min de lecture
Chapitre 03

Ton premier skill : /post

Chapitre 3 sur 10 · 30%

Objectifs de ce chapitre

  • Comprendre ce qu’est un skill et où il vit dans ton projet
  • Créer un skill en décrivant ton besoin (sans écrire le fichier à la main)
  • Tester le pipeline de bout en bout sur une seule plateforme

C'est quoi un skill ?

Jusqu'ici, chaque demande à Claude était jetable : tu écris un prompt, tu obtiens un résultat, et la prochaine fois tu retapes tout. Un skill change ça. C'est une commande slash que tu construis toi-même : tu tapes /post et Claude suit les instructions que tu as définies une fois pour toutes. Les skills persistent entre les conversations : tu les construis une fois, tu les réutilises pour toujours.

C'est le concept le plus important du cours. La différence entre un utilisateur occasionnel et un utilisateur 10x n'est pas la qualité de ses prompts — c'est qu'il capitalise. Chaque problème résolu devient un outil permanent. Au bout de trois mois, l'utilisateur occasionnel retape ses instructions ; l'utilisateur 10x a une boîte à outils de quinze commandes qui encodent toute son expertise métier.

Pour Léa, le skill /post va encoder tout son processus de publication : où chercher l'information, comment structurer un post, quel format d'image générer, comment journaliser. Ce savoir-faire, aujourd'hui dans sa tête, sera demain dans un fichier que Claude exécute à la demande.

Anatomie d'un skill

Un skill vit dans ton projet sous forme d'un dossier contenant un fichier SKILL.md :

text
.claude/
  skills/
    post/
      SKILL.md      <-- les instructions du skill (requis)
      reference.md  <-- (optionnel) doc de référence chargée à la demande
      scripts/      <-- (optionnel) scripts utilitaires du skill

Le fichier SKILL.md contient un en-tête YAML (le « frontmatter » : nom et description) suivi des instructions en Markdown libre. Le nom du dossier devient la commande : .claude/skills/post//post. Voici à quoi ressemble la structure :

text
---
name: post
description: Publie un post sur un réseau social (texte + visuel + journal). Utiliser quand l'utilisateur veut publier ou programmer du contenu.
---

# Rôle
Tu es le gestionnaire de réseaux sociaux de la marque...

# Étapes
1. Identifier la plateforme et le sujet fournis
2. Rechercher le sujet si nécessaire
3. Rédiger le post au format de la plateforme
...

Détail qui compte : la description du frontmatter n'est pas décorative. C'est elle que Claude lit pour décider si le skill est pertinent — il peut même l'invoquer de lui-même quand ta demande correspond, sans que tu tapes la commande. Une bonne description dit ce que fait le skill et quand l'utiliser. Le corps du fichier, lui, n'est chargé en contexte qu'au moment de l'exécution : c'est ce qui permet d'avoir des dizaines de skills sans alourdir chaque session.

Tu n'écris PAS ce fichier à la main. Tu décris ton besoin, Claude crée le dossier et écrit SKILL.md. Tu pourras toujours l'ouvrir, le lire et demander des modifications — mais laisser Claude rédiger la première version est plus rapide et évite les erreurs de format.

Skills projet ou skills personnels ?

.claude/skills/ (projet)Le skill appartient au projet. Versionnable dans Git, partagé avec quiconque clone le repo. C’est le bon choix pour /post : il est lié à la marque de Léa.
~/.claude/skills/ (personnel)Le skill te suit dans tous tes projets. Idéal pour tes outils transverses : résumer une réunion, formater un e-mail, tes conventions personnelles.

La règle de décision est simple : si le skill contient du contexte spécifique au projet (la voix de Léa, ses plateformes, ses API), il va dans le projet. S'il encode une habitude à toi, indépendante du projet, il va dans ton dossier personnel.

Construire le skill (en commençant simple)

On commence par une seule plateforme pour valider tout le pipeline : la génération du texte, du visuel, et la publication. On passera au multi-plateforme plus tard. Cette discipline — réduire le périmètre jusqu'à ce qu'une version minimale marche de bout en bout — est la compétence numéro un de l'automatisation. Colle ce prompt dans Claude Code :

PROMPT
crée un nouveau skill claude code "post" dans ce dossier.

rôle : gestionnaire de réseaux sociaux IA pour linkedin, instagram, twitter, facebook.
l'utilisateur fournit une plateforme + n'importe quelle combinaison de : un sujet, un post à adapter, une URL (youtube, article, pdf), ou ses propres images.
déduis l'intention de ce qui est fourni.
maintiens un fichier journal des posts publiés et de leurs URLs.

pose-moi des questions une à la fois jusqu'à être sûr à 95% de réussir la tâche.

La phrase la plus utile du cours

Remarque la dernière ligne : « pose-moi des questions une à la fois jusqu'à 95% de confiance ». C'est l'un des patterns les plus puissants avec l'IA, et il mérite qu'on s'y arrête.

Le réflexe naturel est d'essayer de tout cadrer dans son premier prompt — et d'échouer, parce que personne ne pense à tout d'avance. Ce pattern inverse la charge : c'est Claude qui t'interroge. Ses questions révèlent les trous de ton raisonnement (« que faire si l'utilisateur fournit une image ET une URL ? », « le journal doit-il inclure les brouillons non publiés ? »), que tu combles par le dialogue plutôt qu'en anticipant tout. Réponds une question à la fois ; quand Claude a assez de contexte, il construit le skill.

Le « une à la fois » est important aussi : si Claude pose huit questions d'un coup, tu réponds superficiellement aux huit. Une à la fois, chaque réponse nourrit la question suivante — c'est une vraie conversation de cadrage, comme avec un freelance compétent qui prend ton brief.

Tester le skill

Ferme puis rouvre une session (les nouveaux skills sont détectés au démarrage). Tape / : tu dois voir /post dans la liste avec sa description. Lance un premier test :

text
/post "astuces de prompts pour débutants" twitter

Claude génère un visuel, rédige le post et le publie (ou le programme), puis journalise le résultat. L'objectif ici n'est pas le volume : c'est de valider le pipeline complet avant de passer à l'échelle. Si une clé API est fausse, un compte mal connecté ou un format d'image refusé par la plateforme, tu le découvres maintenant, sur un seul post de test — pas en publiant une semaine de contenu.

flowchart LR
  A["/post sujet + plateforme"] --> B["Recherche du sujet"]
  B --> C["Rédaction du texte"]
  C --> D["Génération du visuel"]
  D --> E["Publication via API"]
  E --> F["Journal des posts"]
Le pipeline complet du skill /post — chaque maillon est validé sur une seule plateforme d'abord.

Connecter les API sans s'arracher les cheveux

Pour publier réellement, ton skill a besoin d'accéder aux API des réseaux sociaux — soit en appelant directement une API de publication (la plupart des outils de programmation de posts en proposent une), soit via un serveur MCP (Model Context Protocol), le standard qui permet de brancher des outils externes à Claude Code avec la commande claude mcp add. Bonne nouvelle : tu n'as pas besoin de lire la documentation toi-même. Donne l'URL de la doc à Claude et dis-lui « lis cette doc et configure l'intégration ».

Pour les clés API, la convention propre : un fichier .env à la racine du projet (ajouté au .gitignore !), que les commandes référencent sans jamais afficher la valeur. Demande explicitement à Claude de respecter cette convention — et c'est exactement le genre de règle qu'on gravera dans le CLAUDE.md au chapitre 8.

Si /post n'apparaît pas dans la liste : vérifie que le fichier est exactement à .claude/skills/post/SKILL.md (un dossier mal orthographié est l'erreur classique), que le frontmatter YAML est bien présent, puis redémarre la session.
🛠️ À toi de jouer

Contexte

Léa veut son premier post automatisé sur un seul réseau pour vérifier que tout marche. Elle a choisi Twitter comme terrain de test : les posts sont courts, l'itération est rapide, et une erreur y est moins grave que sur LinkedIn où sa clientèle professionnelle la suit. Ton objectif : un pipeline qui tourne de bout en bout, du sujet jusqu'au journal, même si le résultat n'est pas encore parfait.

Consignes

  1. Demande à Claude de créer le skill /post avec le prompt fourni dans le chapitre.
  2. Réponds à ses questions une par une (plateforme de test, ton, longueur, format du journal…) — prends le temps, c’est le cadrage qui fait la qualité.
  3. Ouvre le fichier .claude/skills/post/SKILL.md généré et lis-le : repère le frontmatter et les étapes.
  4. Redémarre la session, tape / et vérifie que /post apparaît avec sa description.
  5. Lance /post "lancement de notre crème hydratante bio" twitter et observe chaque maillon du pipeline.
  6. Vérifie le fichier journal : le post, son URL et sa date doivent y figurer.
  7. Demande une amélioration au skill (par exemple : « ajoute toujours un hashtag de marque ») et relance pour vérifier la prise en compte.
Indice — Si le skill n’apparaît pas, vérifie que le fichier est bien à .claude/skills/post/SKILL.md et que la session a été redémarrée après la création.

En résumé

  • Un skill = une commande slash réutilisable, définie dans .claude/skills/<nom>/SKILL.md.
  • Le frontmatter (name + description) sert à Claude pour savoir quand utiliser le skill ; le corps n’est chargé qu’à l’exécution.
  • Skills projet (.claude/skills/, versionnés) vs skills personnels (~/.claude/skills/, transverses).
  • Tu décris ton besoin ; Claude écrit le SKILL.md pour toi.
  • La phrase « pose-moi des questions une à la fois jusqu’à 95% » fait émerger les détails que tu n’aurais jamais anticipés.
  • Commence par une seule plateforme pour valider tout le pipeline avant de passer à l’échelle.
  • Les clés API vivent dans un .env ignoré par Git ; les intégrations externes passent par les API ou un serveur MCP.

Quiz — vérifie ta compréhension

1. Où vit un skill nommé « post » ?

Le dossier .claude/skills/post/ contient SKILL.md, et son nom devient la commande /post.

2. Pourquoi commencer par une seule plateforme ?

Mieux vaut détecter une clé API fausse sur un test que sur une semaine entière de contenu.

3. À quoi sert la description dans le frontmatter de SKILL.md ?

Une bonne description dit ce que fait le skill et quand l'utiliser : Claude peut même l'invoquer de lui-même si la demande correspond.

4. Pourquoi demander les questions « une à la fois » plutôt que toutes d’un coup ?

Huit questions d'un coup produisent huit réponses superficielles ; une à la fois, le cadrage gagne en profondeur.

5. Quel est le bon endroit pour un skill « formater mes e-mails » que tu veux dans tous tes projets ?

Un skill transverse, indépendant du projet, va dans ton dossier personnel ~/.claude/skills/ pour te suivre partout.

Auteur(s)

R

REHOUMA Haythem

Haythem Rehouma est un ingénieur et architecte IA et cloud, formateur et enseignant technique, avec un profil orienté IA médicale, AWS, MLOps, LLM/RAG et vision par ordinateur.