Un skill Claude, c'est un simple fichier Markdown : un bout de texte qui explique à l'IA quoi faire, quand, et avec quels outils. Pas de terminal, pas de code, pas d'installation compliquée. Si vous savez ouvrir un Google Doc, vous savez écrire un skill.
Anatomie d'un skill
Un skill est constitué de deux parties : un frontmatter YAML (les métadonnées) et un corps Markdown (les instructions).
---
name: relire-contrats
description: Repère les clauses à risque dans un contrat en 2 minutes.
---
# Relire un contrat
Quand l'utilisateur dépose un contrat, ...
Les champs essentiels du frontmatter :
| Champ | Rôle | Exemple |
|---|---|---|
name |
Identifiant unique | relire-contrats |
description |
Déclenche Claude | Repère les clauses à risque... |
tools |
Outils requis | [drive, docs] |
La
descriptionest le plus important : c'est elle qui détermine si Claude active ou non votre skill quand l'utilisateur écrit un message.
Les 3 règles d'or
Un bon skill tient en trois principes :
- Sois spécifique. « Aide-moi avec mes contrats » ne déclenche rien. « Repère les clauses à risque dans un contrat PDF » déclenche tout.
- Donne un rôle. « Tu es un juriste senior. Tu relis... » marche mieux que « Aide à relire. »
- Précise le format de sortie. Demandez une liste à puces, un tableau, un paragraphe, mais précisez-le.
Ce qu'il ne faut pas faire
- Un skill de 2 000 mots qui couvre 15 cas d'usage → éclatez en 15 skills.
- Des instructions contradictoires ("sois concis mais détaillé").
- Oublier le champ
description(sans lui, Claude ne trouvera jamais votre skill).
Exemple complet
Voici un skill « écrire un post LinkedIn » que vous pouvez copier et adapter :
---
name: post-linkedin
description: Rédige un post LinkedIn pro à partir de quelques notes.
---
# Post LinkedIn
Tu es un rédacteur web spécialisé LinkedIn. L'utilisateur te donne 2-3 bullets
ou une idée brute. Tu transformes ça en post de 180 mots max, structuré ainsi :
- Une accroche en 1 ligne qui pose le problème
- 3 à 5 lignes de valeur concrète
- Un CTA en forme de question ouverte
Ton : direct, sans émojis, sans hashtags sauf demande explicite.
Publier votre skill
Une fois votre fichier .md prêt :
- Ouvrez Cowork → Skills → Importer.
- Collez le contenu ou uploadez le fichier.
- Testez dans un nouveau chat.
- Partagez avec votre équipe via le lien d'équipe.
C'est tout. Vous venez de créer votre premier skill Claude.
Pour aller plus loin
- Lisez notre template de skill commercial (à venir)
- Apprenez à chaîner plusieurs skills dans un workflow
- Inscrivez-vous à la formation Rédaction de skills
