Skills dans Claude Code : installer un skill et créer le sien

À force de demander à Claude Code une revue de formulaire, une description de changements ou l'analyse d'une erreur de build, on finit par suivre toujours le même ordre : lire les fichiers utiles, vérifier les conditions, rendre un résultat lisible. Cette procédure peut s'écrire une fois pour toutes sous forme de skill.

Un Skill est un dossier contenant des instructions dans SKILL.md et, si besoin, des ressources complémentaires. L'agent y trouve une procédure répétable avec ses exemples et ses fichiers d'appui. Le format est décrit dans la spécification Agent Skills.

• spécification Agent Skills

Ce guide porte sur l'installation dans Claude Code en local et sur un skill d'exemple qui passe en revue un formulaire de contact. Les commandes ont été vérifiées dans la documentation le 3 octobre 2026. L'exemple est pédagogique : ce n'est pas le compte rendu d'un test sur un site réel.

Choisir une procédure

Choisissez une procédure que vous savez déjà expliquer : « Avant de livrer le formulaire, examiner les champs obligatoires, les messages d'erreur et l'envoi, puis lister les problèmes ».

Pour un premier skill, c'est un meilleur point de départ que « créer de bons sites ». Une revue de formulaire a des entrées, des étapes et un résultat que l'on peut évaluer.

Commencez par une seule ligne du tableau. Un skill qui développe le site, rédige la publicité, configure le serveur et publie le tout est difficile à corriger : on ne sait pas quelle étape a failli.

Installer un dossier de skill

Les skills personnels se rangent dans `~/.claude/skills/`, ceux du projet dans `.claude/skills/` à l'intérieur du dépôt. Chaque skill a son propre dossier avec un SKILL.md. Un skill personnel est disponible dans tous les projets de la machine, un skill de projet se conserve avec le code.

• Emplacements

project/
└── .claude/
    └── skills/
        └── form-review/
            ├── SKILL.md
            └── references/
                └── checklist.md

Si vous avez téléchargé une collection, repérez le dossier du skill voulu et copiez-le en entier. Copier le seul SKILL.md risque de casser les liens vers les ressources jointes.

Vérifiez l'arborescence obtenue. La décompression ajoute souvent un niveau de trop :

.claude/skills/form-review/form-review/SKILL.md

Dans notre exemple, le fichier doit se trouver un niveau plus haut :

.claude/skills/form-review/SKILL.md

Avant de copier, regardez si un dossier porte déjà ce nom. Si c'est le cas, comparez d'abord les versions pour ne pas écraser vos propres modifications.

Installer via un plugin

Si l'auteur distribue ses skills sous forme de plugin, suivez ses instructions d'installation. Pour le dépôt officiel d'Anthropic, les commandes sont les suivantes, à saisir dans Claude Code :

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

La première commande ajoute le marketplace, la seconde installe les exemples. Pour le travail sur les documents, le même dépôt propose `document-skills@anthropic-agent-skills`.

• README officiel

Dossier et plugin sont deux modes de distribution différents. Un SKILL.md isolé trouvé sur GitHub ne s'installe pas avec `/plugin install` : vérifiez d'abord que l'auteur propose un paquet dans un marketplace.

`/plugin install` ouvre la fiche du plugin, où vous choisissez la portée : pour vous dans tous vos projets, pour toutes les personnes qui travaillent sur le dépôt, ou pour vous dans ce seul dépôt. Lisez ensuite le résumé d'installation. Si un rechargement est nécessaire, Claude Code lance en général `/reload-plugins` lui-même. Si le plugin n'a pas pu être chargé, la raison figure dans l'onglet Errors de `/plugin`.

• Installation des plugins

Examiner un skill tiers

Avant le premier lancement, lisez SKILL.md et les scripts fournis, et comparez-les à la tâche. Un skill censé relire un formulaire et qui envoie le contenu du dépôt à un serveur externe vous doit une explication.

Notez d'où vient le skill, quelle version vous utilisez et ce que vous y avez changé. Si une mise à jour modifie le résultat, vous aurez de quoi comparer.

Regardez aussi ce que l'auteur tient pour acquis. Il a pu écrire son skill pour un framework, un jeu de commandes ou un outil de navigateur que votre projet n'a pas. Ces passages sont à remplacer par les vôtres. Aucun skill ne « fonctionne partout ».

Créer un skill de revue de formulaire

Notre skill lit l'implémentation du formulaire et rédige un rapport. Il ne corrige pas le code et n'envoie aucune demande, ce qui permet de séparer la recherche d'un problème de sa réparation.

Créez le dossier `.claude/skills/form-review/` dans votre éditeur. Sous macOS, Linux ou WSL, le terminal fait aussi l'affaire :

mkdir -p .claude/skills/form-review

Créez-y ensuite SKILL.md avec le contenu ci-dessous. C'est un exemple pédagogique, à adapter à votre projet.

---
name: form-review
description: Examine un formulaire de contact et rend compte de la validation, des messages et de l'envoi. À utiliser avant une mise en production.
disable-model-invocation: true
---

# Revue du formulaire

## Objectif
Trouver les erreurs d'implémentation et les vérifications restantes.
Lire les fichiers uniquement. Ne pas modifier le code,
envoyer le formulaire ni contacter de services externes.

## Entrées
Un chemin de formulaire ou un parcours utilisateur est nécessaire.
Si plusieurs formulaires correspondent, demander lequel examiner.

## Procédure
1. Lire le composant, son gestionnaire et les tests associés.
2. Trouver les champs obligatoires et leurs règles.
3. Examiner dans le code les entrées vides et les emails invalides.
4. Suivre les états d'envoi, de succès et d'erreur.
5. Vérifier le traitement explicite des clics répétés pendant l'envoi ;
   sinon, décrire l'incertitude.
6. Comparer les conclusions aux tests. Un test présent n'a pas
   nécessairement été exécuté ni réussi.

## Rapport
Pour chaque problème, indiquer :
- fichier et emplacement ;
- condition de déclenchement ;
- conséquence possible pour l'utilisateur ;
- vérification ou correction proposée.

Lister séparément ce qui exige l'exécution de l'application.
En l'absence de problème évident, le dire sans prétendre
que le formulaire est entièrement vérifié.

En tête du fichier, entre les lignes `---`, viennent les métadonnées, puis la procédure. La spécification ouverte Agent Skills impose `name` et `description`, et le nom doit correspondre à celui du dossier. Claude Code est plus souple : tous les champs y sont facultatifs, seul `description` est recommandé. Le nom accepte les minuscules latines, les chiffres et le tiret.

• Format

`disable-model-invocation: true` est un réglage propre à Claude Code : le skill ne se lance que sur appel manuel, Claude ne le charge pas de lui-même. Nous l'utilisons ici pour que la revue démarre toujours par une commande explicite. La consigne de lecture seule, elle, décrit un comportement. Les droits d'accès techniques se règlent à part.

• Invocation
• permissions

Lancer et évaluer

Ouvrez le projet dans Claude Code et saisissez :

/form-review Examine le formulaire dans src/components/LeadForm.tsx

Le chemin n'est qu'un exemple : indiquez un fichier réel de votre projet. Un skill s'appelle directement sous la forme `/nom-du-skill`.

• Invocation des Skills

Pour tester le skill, prenez un formulaire dont vous connaissez déjà un défaut. Par exemple, le message d'erreur d'envoi disparaît dès qu'on clique de nouveau sur le bouton. Voyez si l'agent relève précisément ce comportement et s'il en montre la cause dans le code.

Jugez le rapport sur quatre points :

1. Il cite des fichiers qui existent et des endroits précis de l'implémentation.
2. Chaque remarque indique la condition qui déclenche le problème.
3. Les hypothèses sont séparées des conclusions étayées par le code.
4. Avoir lu les tests n'est pas présenté comme les avoir exécutés avec succès.

Si vous recevez à la place une longue liste de conseils généraux, durcissez l'exigence de preuve. Ajoutez par exemple : « N'inclus aucune recommandation sans montrer l'implémentation concernée ». Puis relancez la revue sur le même formulaire.

Modifiez une seule partie importante des instructions à la fois, sinon vous ne saurez pas quel changement a rendu la réponse plus utile. Il s'agit d'une méthode de travail éditoriale. Aucun résultat de test du skill n'est rapporté ici.

Décrire le déclenchement automatique

Si le skill doit être choisi automatiquement, décrivez à la fois ce qu'il fait et dans quel cas l'utiliser. Comparez :

Aide à développer des applications.

Et une version plus précise :

Examine les formulaires avant publication : validation, erreurs et états d'envoi. À utiliser pour une revue de formulaire, pas une analyse générale d'architecture.

La seconde version fixe des limites, et l'agent a moins de raisons de choisir le skill pour une tâche sans rapport. La spécification recommande elle aussi d'indiquer dans `description` ce que fait le skill et quand s'en servir.

• Champ description

Dans notre exemple, le choix automatique est désactivé. Si vous l'activez, testez la description avec plusieurs demandes : une qui convient, une voisine et une franchement hors sujet. Observer ce qui se passe en dit plus que juger la formulation à l'oreille.

Si le skill manque ou ne se déclenche pas

Vérifiez d'abord le chemin, le nom exact du fichier SKILL.md et le début du bloc YAML : la ligne `---` doit être la première. Claude Code prend en compte en cours de session les modifications faites dans les dossiers de skills existants. Si le dossier racine `.claude/skills/` a été créé après le début de la session, lancez `/reload-skills`.

• Modification et chargement

Distinguez ensuite deux situations. Le skill est introuvable en appel direct : vérifiez l'installation. Il se lance à la main mais l'agent ne le choisit jamais seul : regardez le mode d'appel et la description.

Quand un skill personnel et un skill de projet portent le même nom, Claude Code exécute le skill personnel. En cas de résultat inattendu, regardez dans les deux dossiers.

• Conflits de noms