Claude Code Skills : créer ses propres compétences pour spécialiser l'IA

Depuis fin 2025, Anthropic a stabilisé un format officiel pour empaqueter une expertise réutilisable dans Claude Code : les Skills. Contrairement aux sous-agents (qui lancent un Claude indépendant) ou aux slash commands (qui scriptent une action), les Skills sont un mode d’emploi que Claude charge automatiquement quand il détecte que la tâche le nécessite. C’est aujourd’hui le mécanisme le plus élégant pour capitaliser une expertise d’équipe.

Skills vs sous-agents vs slash commands : qui fait quoi ?

Mécanisme	Ce que c’est	Quand c’est déclenché
Slash command	Un prompt scripté	L’utilisateur tape /nom
Sous-agent	Un Claude indépendant avec son propre système prompt	L’agent principal délègue explicitement
Skill	Un mode d’emploi (SKILL.md + ressources)	Claude le charge automatiquement quand pertinent

Les trois cohabitent — et se complètent. Un Skill bien écrit peut être déclenché depuis une conversation classique sans que l’utilisateur ait à taper un slash, simplement parce que Claude lit la description et décide que c’est applicable.

Anatomie d’un Skill

Un Skill est un dossier dans ~/.claude/skills/ (ou C:\Users\…\.claude\skills\ sous Windows). Ce dossier contient au minimum un fichier SKILL.md à la racine (Claude Code Docs, 2026) :

~/.claude/skills/
└── audit-geo/
    ├── SKILL.md           # Obligatoire
    ├── REFERENCE.md       # Optionnel : contenu volumineux à charger si besoin
    └── exemples/          # Optionnel : exemples, templates, etc.
        └── faq.md

Le fichier SKILL.md

Structure minimale :

---
name: audit-geo
description: Audite une page web pour sa visibilité dans les moteurs IA (ChatGPT, Perplexity, AI Overviews) selon le framework CITABLE.
---

# Audit GEO

Quand l'utilisateur demande d'auditer une page pour sa visibilité IA ou
GEO, applique le framework CITABLE (7 critères) :

- **C**lear entity and structure
- **I**ntent architecture
- **T**hird-party validation
- **A**nswer grounding
- **B**lock-structured for RAG
- **L**atest and consistent
- **E**ntity graph and schema

Pour chaque critère, donne une note de 1 à 5 et 2 améliorations
prioritaires. Consulte REFERENCE.md pour le détail des critères et
exemples-types.

## Sortie attendue
[...]

Deux champs YAML sont obligatoires :

• name — identifiant court. Devient aussi le slash command /audit-geo.
• description — c’est le champ critique. Claude lit cette description pour décider si le Skill est pertinent ou non sur la tâche courante. Soyez précis : ce que fait le Skill, quand il s’applique, quel est le signal déclencheur.

Au-delà de 500 lignes : l’astuce REFERENCE.md

Si votre expertise a besoin de beaucoup de contenu (grille d’évaluation détaillée, exemples, règles d’exception), ne tassez pas tout dans SKILL.md. Créez des fichiers séparés et référencez-les depuis SKILL.md :

Pour le détail des critères CITABLE et les exemples-types, consulte REFERENCE.md.

Claude ne chargera REFERENCE.md que s’il juge nécessaire pendant l’exécution. C’est ce qui fait que les Skills scalent : vous pouvez documenter 50 pages de règles sans alourdir chaque prompt (Anthropic Help, 2026).

3 Skills à créer en priorité dans une équipe

1. Skill « project-conventions »

Le Skill que charge automatiquement Claude dès qu’il édite du code de votre projet. Contient :

• Conventions de nommage (variables, fichiers, branches git)
• Commandes du projet (npm run test, npm run build)
• Patterns à suivre / éviter
• Points de vigilance (modules legacy, migrations en cours)

C’est le pendant projet de ce que CLAUDE.md fait à la racine. Mais un Skill est portable : il vit dans ~/.claude/skills/ et peut s’appliquer à plusieurs projets qui partagent les mêmes conventions (une stack React + TS dans une entreprise, par exemple).

2. Skill « pr-review »

Déclenché automatiquement quand l’utilisateur demande une revue de PR. Contient la grille d’évaluation de votre équipe : sécurité, performance, tests, doc, respect des conventions, impact BDD. Le SKILL.md détaille chaque dimension, REFERENCE.md contient les exemples-types de bonne/mauvaise pratique.

Résultat : une revue standardisée quel que soit le dev qui la lance, avec une qualité qui ne dépend plus de qui est de garde sur les revues ce jour-là.

3. Skill « incident-postmortem »

Déclenché quand un incident prod est déclaré. Guide Claude à travers le processus postmortem de votre équipe :

1. Timeline des événements à partir des logs
2. Cause racine versus facteurs contribuants
3. Questions à poser aux équipes impactées
4. Template de rapport postmortem
5. Actions correctives à suivre dans le tracker

C’est le genre de processus rare mais critique où l’absence d’une procédure claire coûte des heures à chaque occurrence. Encoder ça une fois dans un Skill rentabilise dès le deuxième incident.

Le Skill Creator — meta-skill officiel

Anthropic maintient un « Skill Creator » officiel dans le repo anthropics/skills. Ce meta-skill pose une série de questions et génère un SKILL.md conforme aux conventions : nommage, structure, bonnes pratiques, ressources auxiliaires (Anthropic Help, 2026).

Pour créer votre premier Skill, c’est la voie la plus propre :

# Invoquer le skill creator
claude
> Je veux créer un skill qui [décrire le cas d'usage]

Le Skill Creator vous guide, pose les bonnes questions sur le trigger, la portée, les ressources nécessaires, et vous livre un dossier Skill prêt à l’emploi.

L’écosystème public

En avril 2026, l’écosystème Skills est très actif :

• Le dépôt officiel anthropics/skills est la référence.
• La communauté maintient awesome-claude-skills — liste de skills publics classés par catégorie.
• Des distributions spécialisées existent : claude-seo (19 sub-skills pour le SEO technique, E-E-A-T, schema, GEO, local SEO) (GitHub, 2026), claude-skills (232+ skills engineering/marketing/produit/compliance) (GitHub, 2026).

Pour un domaine métier donné, commencez par regarder ce qui existe : vous gagnez souvent 80 % du travail en partant d’un Skill communautaire puis en l’adaptant à vos conventions locales.

Portée : user, projet, ou plugin ?

Trois niveaux de diffusion :

• User — ~/.claude/skills/. Personnel à un développeur.
• Projet — .claude/skills/ à la racine du repo. Partagé via git à tous les devs du projet.
• Plugin — distribué comme un package installable. Partagé entre projets et entre entreprises.

La règle simple : projet pour tout ce qui est spécifique à un codebase (conventions, postmortem maison, workflow de release), user pour vos préférences personnelles, plugin pour ce que vous voulez diffuser largement.

Bonnes pratiques issues de l’usage

1. Description précise et actionnable. « Audite une page selon CITABLE » > « Aide au SEO ». La description est lue par Claude pour décider s’il doit charger le Skill.
2. Un Skill = une tâche claire. Comme pour les sous-agents : mieux vaut 5 skills ciblés qu’un skill « couteau suisse ».
3. Utilisez REFERENCE.md pour les contenus volumineux. Ça évite de gonfler chaque prompt.
4. Versionnez les Skills projet dans git. Même règle que pour .claude/agents/ ou .claude/commands/.
5. Testez le trigger. Écrivez votre description, lancez Claude dans un contexte où le Skill devrait se déclencher, vérifiez qu’il se charge. Ajustez la description si besoin.
6. Documentez le Skill dans son README. Pour l’équipe, pas pour Claude — rappeler quand l’utiliser, ce qu’il fait, ses limites.

Skills vs MCP vs agents : comment choisir ?

• Skill = savoir-faire statique. « Comment faire X de manière conforme. »
• MCP = accès à des données/outils externes. « Lire la base de données / l’API Sentry. »
• Sous-agent = exécuteur indépendant avec permissions réduites. « Déléguer X à une session isolée. »
• Slash command = raccourci utilisateur explicite. « Je veux taper /X et déclencher une séquence. »

Les quatre se combinent. Un Skill « security-review » peut utiliser un MCP « Sentry » pour récupérer les CVE, être déclenché via une commande /secreview, et déléguer à un sous-agent spécialisé pour l’analyse. Le tout à partir d’un prompt utilisateur de deux lignes.

Pour aller plus loin

• Claude Code en 2026, le guide complet
• Sous-agents, MCP et hooks en équipe
• Utiliser Claude pour auditer le GEO d’un site
• Dépôt officiel : anthropics/skills
• Liste communautaire : awesome-claude-skills

En résumé

Les Skills sont la brique de capitalisation d’expertise dans l’écosystème Claude. Ce que vous mettez dans un SKILL.md aujourd’hui sera chargé automatiquement par Claude demain, après-demain, et dans six mois, sans effort. C’est l’équivalent d’un playbook d’équipe — mais exécutable.

Pour une équipe qui débute : créez un Skill « project-conventions » et un Skill « pr-review » cette semaine. En deux heures de rédaction, vous éliminez probablement 30 à 60 minutes de prompts répétés chaque jour pour toute l’équipe.