Choisir d’abord ce que vous installez
Claude Code fournit déjà des skills intégrés comme /code-review, /debug et /batch. Un Agent Skill autonome est un répertoire dont le point d’entrée est SKILL.md. Un plugin Claude Code est un paquet pouvant inclure skills, agents, hooks et serveurs MCP.
Choisissez la méthode d’installation adaptée au composant voulu. Un skill autonome n’a pas besoin de devenir un plugin, et un plugin n’est pas simplement un autre nom pour un fichier SKILL.md.
| Besoin | Comment le reconnaître | Par où commencer |
|---|---|---|
| Skill intégré | /code-review, /debug ou /batch | Essayez-le dans Claude Code, sans installer une deuxième copie. |
| Skill autonome | Un dossier organisé autour de SKILL.md | Utilisez la CLI Skills ou copiez le dossier complet dans un emplacement de skills. |
| Plugin | Peut réunir skills, agents, hooks ou serveurs MCP | Ouvrez /plugin et examinez le paquet complet avant de l’activer. |
| Skill synchronisé avec claude.ai | Activé pour votre compte Claude | Utilisez la synchronisation du compte pour Cowork ou le cloud ; un dossier personnel local ne suffit pas. |
Installer un skill GitHub avec la CLI Skills
Exécutez la première commande depuis le dépôt où vous souhaitez le skill. Elle cible explicitement Claude Code et utilise la portée projet par défaut de la CLI. La seconde ajoute la portée personnelle pour un skill volontairement partagé entre vos projets sur cette machine.
Il s’agit d’exemples concrets tirés de la documentation de la CLI, pas d’une recommandation d’installer ce paquet précis. Vérifiez le dépôt, le dossier exact du skill et ses permissions avant de lancer l’installation.
npx skills add vercel-labs/agent-skills --skill frontend-design --agent claude-codenpx skills add vercel-labs/agent-skills --skill frontend-design --agent claude-code -g- Utilisez la portée projet pour une procédure propre à un dépôt ou un skill que l’équipe doit examiner avec le projet.
- Ajoutez -g uniquement pour une procédure volontairement commune à plusieurs projets. Cette option cible votre dossier utilisateur, pas une installation administrateur pour toute la machine.
- Lisez les demandes de l’installateur. N’ajoutez pas --yes pour éviter un choix de source, de portée ou de méthode que vous n’avez pas examiné.
Installation manuelle : copier le dossier complet du skill
Si la source ne permet pas une commande fiable, ouvrez le dépôt indiqué et copiez le répertoire complet du skill. Gardez SKILL.md avec ses scripts, exemples, modèles et fichiers associés ; copier uniquement le point d’entrée peut casser les références.
Claude Code utilise des chemins différents pour les skills du dépôt et les skills personnels. Sous Windows, le chemin personnel dépend du profil utilisateur ; il ne nécessite pas de compte administrateur.
| Portée | Chemin Claude Code | Usage conseillé |
|---|---|---|
| Projet | .claude/skills/<skill-name>/SKILL.md | Un dépôt ; versionnez le dossier si l’équipe doit le partager. |
| Personnelle | ~/.claude/skills/<skill-name>/SKILL.md | Vos projets sur cette machine. Sous Windows, le dossier se trouve sous %USERPROFILE%\.claude\skills\. |
- Conservez une copie de référence sauf besoin volontaire des deux portées.
- Confirmez que le dossier final contient SKILL.md et tous les fichiers référencés.
- Pour une configuration d’équipe portable, préférez le chemin projet et examinez les fichiers versionnés comme les autres instructions du projet.
Vérifier le chemin et la session Claude Code active
La liste de la CLI vérifie ce que l’installateur a placé pour Claude Code. Dans une session interactive Claude Code, lancez /skills pour confirmer que l’application le voit. Examinez aussi le répertoire lorsque la portée exacte importe : la liste et le chemin répondent à des questions différentes.
Invoquez un skill avec /name, ou décrivez une tâche correspondante pour que Claude Code le choisisse si pertinent. Si le répertoire racine .claude/skills n’existait pas au démarrage de la session, lancez /reload-skills pour le détecter ; Claude Code ne surveille pas encore ce nouveau répertoire, donc répétez /reload-skills après chaque modification ultérieure à cet endroit. Dans les répertoires déjà surveillés, les changements de texte de SKILL.md sont détectés sans redémarrage.
npx skills ls -a claude-codenpx skills ls -g -a claude-code- Le nom du dossier ou le champ name de SKILL.md correspond à la commande attendue.
- Le skill apparaît dans /skills dans la session locale où vous l’avez installé.
- Testez-le sur une petite tâche réversible sans secrets ni identifiants de production, puis examinez le résultat et les fichiers modifiés.
Dépanner un skill Claude Code qui n’apparaît pas
Un téléchargement réussi, un skill listé par l’installateur et un skill disponible dans la session courante sont trois vérifications distinctes. Identifiez le symptôme avant de réinstaller : l’origine peut être l’agent cible, le nom de commande ou le type de session.
| Symptôme | Vérification suivante |
|---|---|
| La CLI le liste, mais pas /skills dans Claude Code | Confirmez la cible claude-code et la présence de SKILL.md sous .claude/skills/ (projet) ou ~/.claude/skills/ (personnelle). Si le répertoire racine .claude/skills a été créé après le démarrage, lancez /reload-skills ; répétez après les modifications ultérieures dans ce nouveau répertoire. |
| Il apparaît, mais le nom de /commande est différent | Vérifiez le champ name dans l’en-tête de SKILL.md. Il détermine le nom de commande ; en son absence, Claude Code utilise le nom du répertoire du skill. |
| Il fonctionne dans le terminal, mais pas dans Cowork ou le cloud | Ces deux environnements ignorent l’installation locale ~/.claude/skills/. Activez le skill pour votre compte claude.ai. Les sessions cloud peuvent aussi charger un skill de projet versionné sous .claude/skills/ ; le versionner ne le rend pas disponible dans Cowork. |
Pourquoi un skill local peut manquer dans Cowork ou le cloud
Cowork et les sessions cloud ne lisent pas ~/.claude/skills/ sur votre ordinateur. Les deux chargent les skills activés pour votre compte claude.ai. Les sessions cloud peuvent aussi charger les skills de projet versionnés sous .claude/skills/ dans le dépôt ; Cowork n’obtient pas un skill de projet du seul fait qu’il est versionné. Une installation personnelle -g n’est pas une synchronisation entre machines ou avec le cloud.
Un paquet contenant des hooks, serveurs MCP ou autres composants peut être un plugin plutôt qu’un skill autonome. Utilisez alors la procédure d’installation des plugins et examinez chaque composant activé.
- Pour une session locale dans le terminal, vérifiez le chemin local et la liste /skills de Claude Code.
- Pour Cowork, activez le skill dans votre compte claude.ai. Pour le cloud, activez la synchronisation du compte ou versionnez le skill de projet sous .claude/skills/.
- Pour un plugin, inspectez ses skills, agents, hooks et serveurs MCP avant activation ; ne supposez pas qu’il ajoute seulement du texte.
Examiner la source avant de faire confiance au résultat
Un classement, un nombre d’installations ou une configuration réussie ne prouve pas ce qu’un skill fera dans votre dépôt. Lisez les instructions et fichiers référencés, notez la révision source et vérifiez quels fichiers, commandes, accès réseau ou identifiants seraient nécessaires à la première tâche.
Gardez la première exécution limitée et réversible. Considérez son résultat comme une preuve à examiner, pas comme une autorisation de publier, fusionner ou modifier des systèmes de production.
- Le dépôt source et le répertoire du skill correspondent à ceux que vous vouliez installer.
- Les scripts et fichiers référencés sont compréhensibles et pertinents pour la tâche.
- Le premier test possède des limites claires, un résultat vérifiable par une personne et un moyen de retour arrière.