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

Les tâches répétées acquièrent un ordre habituel : lire les fichiers, vérifier les conditions, puis rendre un résultat clair. Si vous demandez souvent une revue de formulaire, une description de changements ou une analyse d'erreur de build, vous pouvez transformer cette procédure en skill.

Un Skill est un dossier contenant des instructions dans SKILL.md et, éventuellement, des ressources. Il réunit procédure répétable, exemples et fichiers utiles. Voir la spécification Agent Skills.

• spécification Agent Skills

Ce guide concerne Claude Code local et un exemple de revue de formulaire. Les commandes ont été confrontées à la documentation ; l'exemple ne constitue pas un test sur un site réel.

Choisir une procédure

Choisissez une tâche que vous savez expliquer : « Avant de livrer le formulaire, examiner champs obligatoires, erreurs et envoi, puis lister les problèmes ».

Ce périmètre est plus facile à évaluer que « créer de bons sites ». Il possède des entrées, des étapes et un résultat.

Commencez par une ligne. Un skill qui développe, rédige la publicité, configure le serveur et publie sera difficile à améliorer.

Installer un dossier de skill

Les skills personnels vont dans `~/.claude/skills/`, ceux du projet dans `.claude/skills/`. Chacun possède son dossier et SKILL.md. Le premier sert dans plusieurs projets de la machine ; le second se conserve avec le code. Emplacements.

• Emplacements

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

Dans une archive de collection, trouvez le dossier voulu et copiez-le entièrement. Copier seulement SKILL.md peut casser les liens vers les ressources.

Évitez un niveau de trop :

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

Le chemin attendu est :

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

Si ce nom existe déjà, comparez les versions avant de copier afin de préserver vos modifications.

Installer via un plugin

Suivez les instructions de l'auteur si le skill est distribué en plugin. Pour le dépôt officiel Anthropic, saisissez dans Claude Code :

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

La première commande ajoute le marketplace, la seconde les exemples. Le dépôt mentionne aussi `document-skills@anthropic-agent-skills` pour les documents. README officiel.

• README officiel

Dossier et plugin sont deux modes de distribution. Un SKILL.md isolé sur GitHub ne devient pas automatiquement un paquet installable ; vérifiez l'existence d'un marketplace.

Lisez le message d'installation. Si nécessaire, activez avec `/reload-plugins` ; les erreurs figurent dans `/plugin`. La portée choisie rend l'installation personnelle, partagée par le projet ou locale à vous dans ce projet. Installation des plugins.

• Installation des plugins

Examiner un skill tiers

Lisez SKILL.md et les scripts avant de lancer. Comparez leur comportement au besoin : transmettre le dépôt à un serveur externe pour une simple revue de formulaire demande une explication.

Notez source, version et modifications personnelles. Vous pourrez comparer les instructions après une mise à jour.

Vérifiez les prérequis : framework, commandes ou outil navigateur supposés par l'auteur peuvent manquer chez vous. Adaptez ces hypothèses au lieu de promettre une compatibilité universelle.

Créer un skill de revue de formulaire

L'exemple lit l'implémentation et rédige un rapport. Il ne corrige pas le code et n'envoie pas de demande, afin de distinguer diagnostic et réparation.

Créez `.claude/skills/form-review/` dans l'éditeur, ou sous macOS, Linux ou WSL :

mkdir -p .claude/skills/form-review

Ajoutez ce modèle pédagogique à SKILL.md et adaptez-le :

---
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é.

Les métadonnées sont entre les lignes `---`, suivies de la procédure. La spécification impose `name` et `description` ; le nom correspond au dossier. Ici, il utilise minuscules latines et tiret. Format.

• Format

`disable-model-invocation: true` est un réglage Claude Code pour l'appel manuel, choisi ici pour rendre le lancement explicite. La lecture seule est une consigne ; les droits techniques se règlent séparément. Invocation, permissions.

• Invocation
• permissions

Lancer et évaluer

Dans le projet ouvert avec Claude Code :

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

Remplacez ce chemin d'exemple par un fichier réel. L'appel direct prend la forme `/nom-du-skill`. Invocation des Skills.

• Invocation des Skills

Choisissez un formulaire au comportement connu, par exemple une erreur qui disparaît après un nouveau clic. L'agent la détecte-t-il et en montre-t-il la cause dans le code ?

Évaluez quatre points :

1. Fichiers réels et emplacements précis.
2. Condition de déclenchement pour chaque remarque.
3. Hypothèses séparées des conclusions étayées.
4. Lecture des tests distincte d'une exécution réussie.

Si le rapport est générique, renforcez la preuve : « N'inclus aucune recommandation sans montrer l'implémentation concernée ». Recommencez sur le même formulaire.

Changez une partie importante à la fois pour comprendre l'amélioration. C'est une méthode proposée, pas un compte rendu de tests réalisés.

Décrire le déclenchement automatique

Décrivez l'action et l'occasion. Comparez :

Aide à développer des applications.

Avec :

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 délimite mieux le sujet. La spécification recommande d'indiquer quoi faire et quand. Champ description.

• Champ description

L'exemple désactive l'appel automatique. Si vous l'activez, testez une demande pertinente, une voisine et une hors sujet : l'observation est plus utile que la seule impression de lecture.

Si le skill manque ou ne se déclenche pas

Vérifiez chemin, nom SKILL.md et première ligne YAML : `---` doit ouvrir le fichier. Si `.claude/skills/` a été créé après le début de session, redémarrez Claude Code. Modification et chargement.

• Modification et chargement

Distinguez installation et sélection. Si l'appel direct échoue, vérifiez l'installation ; s'il fonctionne mais pas le choix automatique, examinez mode d'appel et description.

À nom identique, le skill personnel est prioritaire sur celui du projet. Regardez les deux dossiers en cas de surprise. Conflits de noms.

• Conflits de noms