Créer des Skills avec Claude

1. Qu'est-ce qu'un Skill dans Claude ?

Un Skill (ou « compétence ») est un module spécialisé que l'on ajoute à Claude pour lui apprendre à accomplir une tâche précise selon vos propres règles, vos modèles, votre vocabulaire ou vos procédures internes. Concrètement, un Skill est un dossier contenant un ensemble d'instructions, de fichiers de référence et parfois de scripts, que Claude charge automatiquement lorsqu'il détecte qu'une tâche correspond à ce Skill.

On peut comparer un Skill à un collègue spécialisé que l'on appelle uniquement quand on a besoin de son expertise : un expert en rédaction juridique, un expert en présentation PowerPoint, un expert en analyse de données financières, etc. Claude reste généraliste, mais devient ponctuellement spécialiste grâce à vos Skills.

La différence entre un Skill, un prompt et un agent

2. À quoi ça sert concrètement ?

Les Skills résolvent un problème majeur : l'incohérence des résultats. Sans Skill, vous devez répéter les mêmes consignes à chaque conversation (« utilise notre charte graphique », « rédige toujours en français formel », « commence par un résumé exécutif »…). Avec un Skill, Claude applique automatiquement vos règles dès qu'il détecte la bonne situation.

Quelques exemples concrets d'usage

3. Prérequis avant de commencer

Avant de créer votre premier Skill, assurez-vous de disposer de :

• Un accès à Claude via Claude.ai, Claude Code, ou l'API Anthropic.
• Un éditeur de texte (VS Code, Sublime Text, ou même le Bloc-notes pour débuter).
• Une idée claire de la tâche à automatiser : plus elle est précise, meilleur sera votre Skill.
• Quelques exemples concrets de la tâche réalisée manuellement (modèles, anciens documents, exemples de bons résultats).
• Optionnel : des notions de Markdown, le format utilisé pour rédiger les instructions du Skill.

4. Structure d'un Skill : les fichiers nécessaires

Un Skill prend la forme d'un dossier portant le nom de votre compétence. À l'intérieur, on trouve obligatoirement un fichier central appelé SKILL.md et, en option, des fichiers de support.

Arborescence type

Le fichier SKILL.md : cœur du Skill

Ce fichier commence par un en-tête appelé front matter YAML qui précise le nom du Skill et sa description. Cette description est cruciale : c'est elle que Claude lit pour décider d'activer ou non le Skill.

---
name: rediger-email-commercial
description: |
  Utilise ce Skill chaque fois que l'utilisateur demande de rédiger,
  réviser ou améliorer un email commercial à destination d'un prospect
  ou d'un client B2B. Déclencheurs : "email commercial", "mail de prospection",
  "relance client", "proposition commerciale".
---

# Skill : Rédaction d'emails commerciaux

## Objectif
Produire des emails commerciaux clairs, personnalisés et orientés conversion,
respectant la charte de communication de l'entreprise.

## Méthode (à suivre dans l'ordre)
1. Identifier le destinataire et son secteur.
2. Définir l'objectif unique de l'email (RDV, démo, signature…).
3. Structurer l'email selon le modèle AIDA.
4. Limiter la longueur à 150 mots maximum.
...

5. Créer un Skill étape par étape

Définir clairement le périmètre

Posez ces questions sur une feuille blanche :

• Quelle est la tâche exacte que ce Skill doit accomplir ?
• Quels sont les inputs (informations de départ) ?
• Quel est l'output attendu (format, longueur, ton) ?
• Quelles règles métier doivent être respectées ?
• Quels exemples illustrent un bon et un mauvais résultat ?

Créer le dossier du Skill

Sur votre ordinateur, créez un dossier portant un nom court, en minuscules et avec des tirets. Exemple : compte-rendu-reunion.

Rédiger le fichier SKILL.md

Ouvrez votre éditeur et créez un fichier SKILL.md à l'intérieur du dossier. Structurez-le ainsi :

---
name: nom-du-skill
description: |
  Description claire et orientée déclencheurs.
---

# Titre du Skill

## Objectif
Une phrase qui résume ce que fait le Skill.

## Quand l'utiliser
Liste des situations dans lesquelles Claude doit l'activer.

## Méthode
Étapes numérotées que Claude doit suivre.

## Format de sortie
Description précise du livrable attendu.

## Règles à respecter
Points de vigilance, vocabulaire interdit, ton, longueur…

## Exemples
Un ou deux exemples avant/après.

Ajouter des fichiers de référence (si besoin)

Créez un sous-dossier references/ et ajoutez-y vos modèles, glossaires ou check-lists. Mentionnez ces fichiers dans votre SKILL.md pour que Claude sache les consulter.

## Ressources à consulter
- references/modele-email.md : modèle type à respecter
- references/vocabulaire-interne.md : terminologie de l'entreprise

Ajouter des scripts (optionnel)

Pour des tâches techniques (calculs, conversion de fichiers, manipulation Excel), vous pouvez fournir des scripts Python que Claude exécutera. Placez-les dans un dossier scripts/ et documentez leur usage dans SKILL.md.

Importer le Skill dans Claude

Selon votre environnement :

• Claude.ai (interface web) : importez le dossier via le panneau « Skills » dans les paramètres de votre espace.
• Claude Code : placez le dossier dans ~/.claude/skills/ ou dans le dossier .claude/skills/ de votre projet.
• API Anthropic : référencez le Skill via le paramètre adéquat lors de l'appel API.

6. Exemple complet : Skill « Rédaction d'emails commerciaux »

Voici un Skill complet que vous pouvez recopier puis adapter à votre contexte.

Fichier SKILL.md

---
name: email-commercial-b2b
description: |
  À utiliser dès que l'utilisateur demande de rédiger, réviser ou
  améliorer un email commercial B2B (prospection, relance, proposition,
  remerciement après RDV). Déclencheurs : "email commercial",
  "mail de prospection", "email de relance", "écrire à un prospect".
---

# Skill : Email commercial B2B

## Objectif
Rédiger des emails commerciaux courts, personnalisés et orientés action,
qui maximisent le taux de réponse en respectant la charte de l'entreprise.

## Quand l'utiliser
- Premier contact avec un prospect.
- Relance après un email sans réponse.
- Suivi après un rendez-vous commercial.
- Envoi d'une proposition commerciale.

## Méthode
1. Demander à l'utilisateur :
   - Le nom et la fonction du destinataire.
   - Le secteur de son entreprise.
   - L'objectif précis de l'email.
   - Le contexte (premier contact, relance, suivi…).
2. Structurer l'email selon le modèle AIDA :
   - **Accroche** personnalisée (1 phrase, max 15 mots).
   - **Intérêt** : un bénéfice concret pour le destinataire.
   - **Désir** : une preuve (chiffre, cas client, témoignage).
   - **Action** : une seule demande claire (RDV, démo, réponse).
3. Limiter à 150 mots maximum.
4. Éviter le jargon, les superlatifs et les emojis.
5. Proposer 2 objets d'email A/B.

## Format de sortie
**Objet A :** ...
**Objet B :** ...

**Corps de l'email :**
[texte de l'email]

**Signature suggérée :**
[Prénom Nom]
[Fonction] – [Entreprise]

## Règles à respecter
- Vouvoyer systématiquement.
- Pas plus d'une question dans l'email.
- Toujours inclure un appel à l'action explicite.
- Bannir les formules comme "N'hésitez pas à...", "Cordialement,".
- Préférer "Bien à vous" comme formule de politesse.

## Exemple
**Mauvais :**
"Bonjour, j'aimerais vous présenter notre solution révolutionnaire qui
va transformer votre business. N'hésitez pas à me recontacter !"

**Bon :**
"Bonjour Marie, j'ai vu que [Entreprise] venait de lever 5M€ — bravo.
Nous aidons les scale-ups B2B à diviser par 2 leur cycle de vente
(Doctolib, Alan, Spendesk). Auriez-vous 15 minutes mardi pour en parler ?
Bien à vous, Paul"

7. Tester et améliorer son Skill

Un Skill ne se rédige jamais parfaitement du premier coup. Voici une méthode itérative simple pour le faire évoluer.

Phase 1 — Tester l'activation

Lancez 5 à 10 prompts différents qui devraient déclencher le Skill et vérifiez qu'il s'active bien. Si Claude n'utilise pas le Skill, c'est presque toujours la description qu'il faut enrichir avec plus de mots-clés et de contextes.

Phase 2 — Tester la qualité du résultat

Donnez 3 à 5 cas réels au Skill et évaluez chaque sortie selon une grille simple :

Phase 3 — Tester les cas limites

Testez le Skill avec des demandes volontairement floues, partielles ou hors-sujet. Un bon Skill doit poser les bonnes questions de clarification plutôt que de produire un résultat médiocre.

Phase 4 — Versionner

Numérotez vos versions (v1.0, v1.1…) et gardez un journal des changements en bas du SKILL.md :

## Historique
- v1.2 (mai 2026) : ajout de la règle "1 question max par email".
- v1.1 (mars 2026) : nouveaux exemples B2B SaaS.
- v1.0 (janvier 2026) : version initiale.

8. Cas d'usage professionnel concret

9. Bonnes pratiques et erreurs à éviter

Les 7 règles d'or

1. Un Skill, une mission. Évitez les Skills « couteaux suisses ». Préférez plusieurs Skills spécialisés.
2. Soignez la description. C'est elle qui détermine l'activation automatique du Skill.
3. Donnez des exemples concrets. Un exemple vaut mieux que dix règles abstraites.
4. Documentez le « pourquoi ». Expliquer la raison d'une règle aide Claude à mieux la respecter.
5. Restez bref dans le SKILL.md. Visez 200 à 600 lignes maximum. Au-delà, déportez vers des fichiers de référence.
6. Itérez rapidement. Publiez une v0.1, testez, améliorez. N'attendez pas la perfection.
7. Versionnez et partagez. Un Skill est un actif d'entreprise : sauvegardez-le, partagez-le, formez vos équipes.

Les pièges courants

10. Pour aller plus loin

Combiner plusieurs Skills

Vos Skills peuvent se compléter : un Skill analyse-besoin-client peut alimenter un Skill rediger-proposition. Claude orchestre intelligemment l'enchaînement quand le contexte le demande.

Partager vos Skills

Au sein d'une équipe, hébergez vos Skills dans un dépôt Git partagé (GitHub, GitLab). Chaque collaborateur peut alors les installer en local ou les synchroniser automatiquement.

Construire une bibliothèque de Skills

Les organisations qui réussissent avec Claude bâtissent progressivement une bibliothèque interne de 20 à 100 Skills couvrant leurs principaux processus métiers. C'est un véritable patrimoine intellectuel qui s'enrichit avec le temps.

Connecter les Skills à des outils externes

Via les connecteurs MCP (Model Context Protocol), vos Skills peuvent interagir avec Slack, Google Drive, Notion, Salesforce, etc. Cela transforme un simple module de rédaction en véritable agent métier.