Guide Skills Claude 2026 : Apprends à ton IA tes propres méthodes de travail

TL;DR :

• Un Skill, c'est quoi : Un dossier avec un fichier SKILL.md qui apprend à Claude comment faire une tâche spécifique. C'est un SOP (Standard Operating Procedure) pour l'IA.
• Pourquoi c'est utile : Les LLM ont une fenêtre de connaissance qui s'arrête à plusieurs mois en arrière. Un Skill comble ce fossé en donnant à Claude les bonnes pratiques à jour d'un outil, d'une API ou d'un workflow.
• L'anatomie : Trois couches. Le frontmatter (nom + description) est chargé en permanence. Le corps du SKILL.md ne se charge que quand le skill est déclenché. Les assets (scripts, références, templates) ne se chargent qu'à la demande.
• Mon usage concret : J'ai créé des Skills pour ElevenLabs (voix IA), Nano Banana (images IA) et la création de contenu Sam Tennis. Un Skill bien écrit change la qualité de l'output de manière visible.

Skill Claude = SOP pour l'IA : un Skill est un dossier avec un fichier SKILL.md qui apprend à Claude comment exécuter une tâche spécifique. Le frontmatter est chargé en permanence, le corps se charge au déclenchement, les assets à la demande. C'est du File Engineering appliqué aux workflows.

---

Salut 👋

Si tu utilises Claude régulièrement, tu as probablement remarqué un problème : Claude ne connaît pas les dernières versions de tes outils. Tu lui demandes de générer un script ElevenLabs, il utilise une syntaxe d'il y a 6 mois. Tu lui demandes un prompt pour Nano Banana, il ne connaît pas les dernières fonctionnalités du modèle.

C'est normal. Les LLM ont une fenêtre de connaissance qui se ferme plusieurs mois avant la date du jour. Et les outils IA évoluent toutes les semaines.

Les Skills résolvent ce problème. Au lieu de répéter les mêmes instructions à chaque conversation, tu les écris une fois dans un fichier, et Claude les applique automatiquement chaque fois que le sujet revient. C'est du File Engineering appliqué à tes workflows.

Ce guide couvre tout : ce qu'est un Skill, comment en créer un, les bonnes pratiques pour qu'il fonctionne bien, et mes cas d'usage concrets sur Sam Tennis et Make Time.

1. Un Skill, c'est quoi exactement ?

La version simple

Un Skill est un dossier qui contient un fichier SKILL.md. Ce fichier explique à Claude comment faire une tâche spécifique. Quand Claude détecte que ta demande correspond à un Skill, il charge les instructions et les applique.

C'est l'équivalent d'un SOP (Standard Operating Procedure) pour une IA. Dans une entreprise, tu donnes un SOP à un nouvel employé pour qu'il sache comment exécuter une tâche. Un Skill, c'est le même concept pour Claude.

La structure d'un Skill

.claude/skills/
└── mon-skill/
    ├── SKILL.md          ← Le seul fichier obligatoire
    ├── scripts/          ← Code réutilisable que Claude peut exécuter
    ├── references/       ← Documentation que Claude consulte à la demande
    └── assets/           ← Templates, images, fichiers utilisés en sortie

Le dossier .claude/skills/ est un dossier caché à la racine de ton projet (ou de ton workspace Cowork). Chaque Skill a son propre sous-dossier. Le seul fichier obligatoire est SKILL.md. Le reste est optionnel.

Les deux types de Skills

Les Skills de capacité aident Claude à faire quelque chose que le modèle de base ne fait pas bien. Par exemple : remplir un formulaire PDF, utiliser une API récente, ou générer des images dans un style précis. Ces Skills peuvent devenir inutiles quand les modèles s'améliorent.

Les Skills de préférence encodent ton workflow spécifique. Par exemple : tes conventions de nommage, ton process de review de code, ou le ton de ta marque. Ces Skills sont durables parce qu'ils reflètent tes choix, pas les limites du modèle.

2. L'anatomie d'un SKILL.md

Un fichier SKILL.md a trois couches. Comprendre ces couches est important parce qu'elles déterminent quand et comment Claude charge les informations.

Couche 1 : Le frontmatter (toujours chargé)

---
name: elevenlabs-voice
description: >
  Génère des scripts audio optimisés pour ElevenLabs.
  Utiliser quand l'utilisateur veut créer une voix,
  un script audio, ou générer du son avec ElevenLabs.
---

Le frontmatter est un bloc de métadonnées entre deux lignes --- en haut du fichier. Il contient le nom du Skill et sa description. C'est la partie la plus critique : le frontmatter est chargé dans le contexte de Claude à chaque conversation, même si le Skill n'est pas utilisé.

C'est lui qui déclenche le Skill. Quand tu écris un message, Claude scanne les descriptions de tous tes Skills et décide lequel est pertinent. Si ta description est vague, Claude ne saura pas quand activer le Skill. Si elle est trop large, le Skill se déclenchera sur des requêtes où il n'est pas pertinent.

Couche 2 : Le corps du SKILL.md (chargé au déclenchement)

## Objectif

Créer des scripts audio optimisés pour la dernière version d'ElevenLabs.

## Règles

- Toujours utiliser les marqueurs SSML pour l'intonation
- Insérer des pauses naturelles avec <break time="0.5s"/>
- Adapter le débit selon le type de contenu (narration vs dialogue)

## Exemple de script optimisé

```xml
<speak>
  <prosody rate="medium">
    Salut les joueurs. <break time="0.3s"/>
    Aujourd'hui, on va parler de ton premier set.
  </prosody>
</speak>
```

Le corps ne se charge que quand Claude a décidé d'utiliser le Skill. C'est là que tu mets les vraies instructions : les règles, les exemples, les formats attendus, les pièges à éviter.

Couche 3 : Les assets (chargés à la demande)

Les dossiers scripts/, references/ et assets/ contiennent des fichiers que Claude peut consulter quand il en a besoin. Un script Python pour extraire des données, une documentation d'API, un template de sortie. Claude ne les charge que s'il en a besoin pendant l'exécution du Skill.

Pourquoi cette architecture en couches ?

C'est le principe de progressive disclosure (divulgation progressive). Moins Claude a de contexte en mémoire à un instant donné, meilleure est la qualité de sa réponse. Et moins ça coûte en tokens.

Si tu as 10 Skills, seuls les 10 frontmatters sont en mémoire en permanence (quelques dizaines de tokens chacun). Quand un Skill est déclenché, Claude charge le corps (quelques centaines de tokens). Et seulement si nécessaire, il va chercher un asset spécifique.

C'est la même logique que le File Engineering : donner le bon contexte au bon moment, pas tout le contexte tout le temps.

3. Créer un Skill : la méthode pas à pas

Étape 1 : Identifier le besoin

Pose-toi une question simple : est-ce que je répète les mêmes instructions à Claude régulièrement ? Si oui, c'est un Skill.

Exemples concrets :

• "Chaque fois que je demande un prompt Nano Banana, je dois réexpliquer le style 3D de Sam Tennis"
• "Chaque fois que je veux un script ElevenLabs, je dois rappeler les marqueurs d'émotion"
• "Chaque fois que je crée un post LinkedIn, je dois rappeler mon ton de voix"

Étape 2 : Écrire le SKILL.md (ou le faire écrire)

Tu peux écrire le SKILL.md toi-même ou demander à Claude de le faire. Dans les deux cas, le point de départ est le même : tes instructions actuelles.

Si tu as un SOP, un document de process, ou même juste une liste de règles que tu suis, donne-les à Claude avec cette demande :

"Transforme ces instructions en un Skill Claude. Le fichier doit avoir un frontmatter avec un nom et une description précise, puis le corps avec les règles et des exemples."

Claude va structurer ça dans le bon format.

Étape 3 : Placer le fichier au bon endroit

Le Skill doit être dans le dossier .claude/skills/ de ton workspace. Crée un sous-dossier avec le nom du Skill et place le SKILL.md dedans.

.claude/skills/
└── elevenlabs-voice/
    └── SKILL.md

Sur Mac, le dossier .claude est caché par défaut. Pour l'afficher dans le Finder : Shift + Cmd + . (point). Sur Windows, fais un clic droit dans l'explorateur et active "Afficher les éléments masqués".

Étape 4 : Tester

Ouvre une nouvelle conversation avec Claude et fais une requête qui devrait déclencher le Skill. Vérifie que :

• Le Skill se déclenche sur les bonnes requêtes
• Le Skill ne se déclenche PAS sur les requêtes non pertinentes
• Les instructions sont bien suivies
• Le résultat est meilleur qu'avant le Skill

Si le Skill ne se déclenche pas, le problème est presque toujours dans la description du frontmatter. C'est le premier endroit à corriger.

4. Les 7 bonnes pratiques pour des Skills efficaces

1. La description est le déclencheur

La description du frontmatter est la partie la plus importante du Skill. Si elle est vague ("aide avec les documents"), Claude ne saura pas quand l'activer. Si elle est précise ("crée, édite et analyse des fichiers .docx, utiliser pour le suivi des modifications, les commentaires, le formatage ou l'extraction de texte"), Claude comprend exactement le périmètre.

Inclus toujours le quoi (ce que le Skill fait) ET le quand (dans quelles situations l'utiliser). J'ai vu des améliorations de 50% sur le taux de déclenchement juste en améliorant la description.

2. Écris des instructions, pas des essais

Claude est intelligent. Ton job est de lui dire ce qu'il ne sait pas déjà. Les recherches montrent que des contextes trop longs et trop détaillés dégradent les performances.

• Utilise des directives : "Toujours utiliser interactions.create()" plutôt que "L'API Interactions est l'approche recommandée". La première est une instruction, la seconde est une information que Claude n'utilisera pas.
• Les exemples d'abord : Un extrait de code de 5 lignes bat un paragraphe d'explication de 5 lignes.
• Explique le pourquoi : Quand une règle est importante, dis pourquoi. "Utiliser le modèle X, le modèle Y est déprécié et retournera des erreurs" aide Claude à généraliser.

3. Garde le Skill compact

Le corps du SKILL.md devrait rester sous les 500 lignes. Si ton Skill couvre plusieurs sujets (par exemple : déploiement AWS vs GCP), sépare-les dans des fichiers de référence distincts dans le dossier references/. Claude ne chargera que celui dont il a besoin.

Si un fichier de référence dépasse 500 lignes, ajoute une table des matières avec des indications de lignes en haut pour que Claude puisse trouver rapidement ce qu'il cherche.

4. Donne de la liberté, pas des procédures rigides

Une erreur fréquente : transformer le Skill en workflow étape par étape ("Étape 1 : Lire le fichier. Étape 2 : Parser le JSON. Étape 3 : Extraire les champs..."). Quand tu dictes chaque étape, tu retires à Claude sa capacité à s'adapter, à récupérer après une erreur, ou à trouver une meilleure approche.

Décris ce que tu veux obtenir, pas le chemin pour y arriver :

• Pas idéal : "Étape 1 : Créer une branche. Étape 2 : Faire la modification. Étape 3 : Lancer les tests. Étape 4 : Ouvrir une PR."
• Mieux : "Toujours lancer les tests avant d'ouvrir une PR. Ne jamais push directement sur main."

Si l'ordre exact des étapes est critique et qu'inverser deux étapes casse tout, c'est un problème de scripting, pas de Skill. Mets ça dans un script Python dans le dossier scripts/.

5. Définis les cas négatifs

Pense aux moments où le Skill ne devrait pas se déclencher. Une description comme "utiliser pour toute tâche de code" va parasiter chaque requête.

Exemple : "Utiliser pour les fichiers PDF. Ne PAS utiliser pour l'édition de documents texte, les tableurs ou les fichiers Markdown."

Tester les cas "devrait se déclencher" ET "ne devrait pas se déclencher" est indispensable. Sans ça, tu optimises le Skill dans une seule direction.

6. Teste avant de valider

Ne valide pas un Skill sans l'avoir testé avec plusieurs requêtes différentes. Un seul test ne suffit pas parce que chaque exécution peut donner un résultat différent.

Le process :

• Lance le Skill manuellement avec des requêtes variées. Note où il casse.
• Définis à quoi ressemble le "succès" de manière mesurable.
• Teste avec 10-20 requêtes : des requêtes que le Skill doit gérer, des requêtes qu'il doit ignorer, et des cas limites.
• Si un test échoue, corrige d'abord la description. La plupart des problèmes viennent du déclenchement, pas des instructions.

7. Sache quand retirer un Skill

Lance tes tests sans le Skill. S'ils passent, le modèle a absorbé la valeur du Skill et celui-ci n'est plus nécessaire. Retire-le. C'est particulièrement vrai pour les Skills de capacité : à mesure que les modèles s'améliorent, le fossé se réduit.

5. Mes Skills en production : cas concrets

Skill ElevenLabs (Sam Tennis)

Le problème : Claude génère des scripts audio pour ElevenLabs avec une syntaxe datée. C'est l'outil que j'utilise pour produire les vidéos Sam Tennis, mais la documentation évolue vite. Les dernières fonctionnalités (marqueurs d'émotion avancés, contrôle fin de l'intonation, nouveaux paramètres de voix) ne sont pas dans sa fenêtre de connaissance.

La solution : J'ai compilé les bonnes pratiques de la dernière version d'ElevenLabs (documentation officielle, changelogs, guides de la communauté) dans un Skill. Le SKILL.md contient les règles de formatage audio, les marqueurs d'émotion disponibles, les paramètres de voix optimaux et des exemples de scripts qui fonctionnent bien.

Le résultat : Les scripts audio générés par Claude sont nettement meilleurs. Les voix sonnent plus naturelles, les pauses sont mieux placées, et l'émotion passe mieux. La différence est audible.

Skill Nano Banana (Sam Tennis)

Le problème : Nano Banana (le modèle de génération d'images de Google, via Gemini) a des spécificités de prompting que Claude ne connaît pas. Le style 3D du golden retriever de Sam Tennis nécessite des paramètres précis pour être cohérent d'une image à l'autre.

La solution : Le Skill contient les bonnes pratiques de prompting Nano Banana Pro et Nano Banana 2, les styles supportés, les paramètres de qualité, et des exemples de prompts qui produisent le rendu 3D cohérent de Sam Tennis. Il inclut aussi le contexte visuel de la marque (palette de couleurs, style d'infographies, ambiance générale).

Le résultat : Les infographies de mes vidéos sont visuellement cohérentes. Claude génère des prompts Nano Banana qui produisent le bon style du premier coup, au lieu de nécessiter 3-4 itérations.

Comment ces Skills s'intègrent dans mon workflow

Pour créer une vidéo Sam Tennis, j'utilise les deux Skills en séquence :

1. Claude (connecté à Supabase via Cowork) analyse les stats FFT et rédige le script vidéo
2. Le Skill ElevenLabs se déclenche quand je demande le script audio, et Claude formate le texte avec les bons marqueurs
3. Le Skill Nano Banana se déclenche quand je demande les infographies, et Claude génère des prompts optimisés pour chaque visuel

Sans ces Skills, chaque étape nécessiterait que je rappelle manuellement les bonnes pratiques. Avec les Skills, Claude les applique automatiquement. C'est du temps gagné sur chaque vidéo, multiplié par le nombre de vidéos produites.

6. Les Skills auto-évolutifs : le vrai pouvoir

Un détail qui change tout : les Skills ne sont pas figés. Si Claude rencontre un problème pendant l'exécution d'un Skill (un service qui a changé, une API qui retourne une erreur inattendue, un format qui ne fonctionne plus), il peut identifier le problème et mettre à jour le Skill lui-même. C'est la même logique d'itération autonome que celle d'AutoResearch : l'agent détecte, corrige, et améliore sans intervention humaine.

C'est comparable à un employé qui suit une procédure, remarque qu'une étape est obsolète, et met à jour le document pour le prochain passage. Sauf que Claude le fait automatiquement.

En pratique, mes Skills ElevenLabs et Nano Banana se sont améliorés au fil des utilisations. Claude a ajouté des cas limites que je n'avais pas anticipés, corrigé des paramètres qui ne fonctionnaient plus, et affiné les exemples.

7. Skill Creator : créer des Skills avec un Skill

Si tu utilises Claude via Cowork, il existe un Skill intégré appelé Skill Creator. C'est un méta-skill : un Skill dont le job est de créer d'autres Skills.

Tu lui décris ce que tu veux automatiser, et il génère le dossier complet avec le SKILL.md structuré, le frontmatter optimisé, et les assets nécessaires. C'est le moyen le plus rapide de démarrer si tu n'as jamais créé de Skill.

Le process est simple :

1. Décris ton workflow à Claude : "Je veux un Skill qui génère des posts LinkedIn dans mon ton de voix"
2. Claude (via le Skill Creator) génère le fichier SKILL.md avec le bon frontmatter, les bonnes instructions et des exemples
3. Tu testes, tu ajustes la description si le déclenchement n'est pas bon, et c'est en production

8. Par où commencer ?

Si tu n'as jamais créé de Skill, voici un ordre qui fait sens :

Commence par un Skill de préférence simple. Ton ton de voix, tes conventions de code, ton format de rapport. C'est un Skill qui encode tes choix et qui n'a pas besoin de se connecter à un service externe. Le risque est faible, la valeur est immédiate.

Passe ensuite à un Skill de capacité. Un outil que tu utilises souvent et dont Claude ne connaît pas bien la dernière version. ElevenLabs, Midjourney, une API spécifique. Compile les bonnes pratiques dans un Skill et mesure la différence de qualité.

Concentre tes Skills sur ce qui génère de la valeur. Les meilleurs Skills ne sont pas les plus techniques. Ce sont ceux qui automatisent les tâches récurrentes qui ont un impact direct sur ton activité : création de contenu, prospection, analyse de données, suivi client. Ne construis pas des Skills parce que c'est possible. Construis-les parce que ça fait gagner du temps ou de l'argent.

Conclusion : les Skills comme avantage compétitif

Les Skills sont la prochaine étape logique après le File Engineering. Le File Engineering donne du contexte à l'IA. Les Skills lui donnent des compétences.

Un Claude sans Skills est un assistant généraliste. Un Claude avec des Skills calibrés sur tes outils et tes workflows est un spécialiste de ton métier. La différence de qualité dans les outputs est visible dès le premier usage.

Et comme les Skills s'améliorent au fil des exécutions, la valeur s'accumule. Chaque utilisation rend le Skill un peu meilleur. C'est un investissement qui compose.

À très vite,

Guillaume 👋

---

---

Questions fréquentes

Quelle est la différence entre un Skill Claude et un prompt système ?

Un prompt système est chargé en début de conversation et reste en mémoire pendant toute la session. Un Skill ne se charge que quand il est pertinent, grâce au mécanisme de progressive disclosure. Si tu as 10 Skills, seuls les frontmatters (quelques dizaines de tokens chacun) sont en mémoire en permanence. Le corps du Skill ne se charge que quand Claude détecte qu'il en a besoin. Résultat : moins de tokens consommés, meilleure qualité de réponse.

Combien de Skills peut-on avoir en même temps ?

Il n'y a pas de limite technique. En pratique, chaque Skill ajoute son frontmatter au contexte permanent de Claude. Si tu as 50 Skills avec des descriptions longues, ça peut commencer à peser. La bonne pratique est de garder des descriptions concises (2-3 lignes) et de retirer les Skills que tu n'utilises plus.

Les Skills fonctionnent-ils avec Cursor ou seulement avec Claude ?

Les Skills au format .claude/skills/ sont spécifiques à Claude (via Cowork). Cursor utilise un système équivalent : les fichiers .cursor/rules/ et les AGENTS.md. Le principe est le même (du File Engineering pour donner du contexte à l'IA), mais le format et l'emplacement des fichiers diffèrent.

Comment savoir si un Skill est toujours utile ?

Lance tes requêtes habituelles sans le Skill activé. Si la qualité des réponses est la même, le modèle a absorbé la valeur du Skill et tu peux le retirer. C'est particulièrement fréquent avec les Skills de capacité : à mesure que les modèles s'améliorent, le fossé entre "avec Skill" et "sans Skill" se réduit.

---

Pour aller plus loin

• Guide File Engineering (Anthropic) - Le principe fondateur : donner le bon contexte au bon moment
• AutoResearch : 700 expériences dirigées par un fichier Markdown - La même logique d'itération autonome, appliquée à la recherche IA
• Agent Harness : l'infrastructure IA - L'infrastructure qui encadre les agents IA autonomes
• Guide Cursor 2026 - L'équivalent des Skills côté Cursor (Rules, AGENTS.md)
• Build in Public #8 : 150 000 vues pour 33€ - Le workflow vidéo Sam Tennis où j'utilise ces Skills
• Voir tous mes outils recommandés