Comment installer un skill dans Claude, et quoi vérifier s'il ne se charge pas

Comment installer un skill dans Claude Code (terminal, application de bureau ou VS Code) ?

Copiez le dossier du skill dans un répertoire de skills : ~/.claude/skills/ pour tous vos projets, ou .claude/skills/ dans un projet pour ce projet seulement. Claude Code cherche chaque skill à l'adresse skills/<nom-du-skill>/SKILL.md : le SKILL.md doit donc se trouver exactement un dossier sous skills/.

1. Créez le dossier s'il n'existe pas : ~/.claude/skills/ pour tous vos projets, ou <projet>/.claude/skills/ pour un seul.
2. Copiez-y le dossier du skill, en gardant son nom. Un skill livré en fichier .skill est une archive ZIP dont la racine est ce dossier : dézippez-la à cet endroit.
3. Claude Code surveille ces dossiers et prend en compte les skills ajoutés ou modifiés dans la session en cours. Si le dossier de skills n'existait pas au démarrage de la session, lancez /reload-skills ou redémarrez. Claude Code ne surveille pas un dossier créé en cours de session : relancez /reload-skills après chaque modification suivante.
4. Lancez /skills pour voir ce qui est chargé.

mkdir -p ~/.claude/skills
unzip dist/site-xray.skill -d ~/.claude/skills

L'onglet Code de l'application de bureau lit le même ~/.claude/skills/ dans les sessions locales. Une session SSH lit ~/.claude/skills/ sur la machine distante, pas sur la vôtre.

Dans l'extension VS Code, tapez /skills dans le panneau pour ouvrir la liste des skills (Claude Code v2.1.280 ou plus récent). La page VS Code d'Anthropic ne donne pas de dossier de skills propre à l'extension, et précise que le panneau n'offre qu'une partie des commandes : s'il en manque une, lancez claude dans le terminal intégré de VS Code, ce qui suppose d'avoir installé la CLI à part.

Faut-il installer un skill pour tous vos projets ou pour un seul ?

Installez un skill pour tous vos projets (skill personnel, dans ~/.claude/skills/) si vous le voulez partout sur votre machine. Installez-le dans un projet (dans .claude/skills/ à la racine) s'il ne concerne qu'un code source ou si votre équipe doit l'avoir aussi : versionnez ce dossier dans git, et chaque personne qui clone le dépôt le reçoit.

Si le même nom de skill existe aux deux endroits, Claude Code exécute le skill personnel. La documentation d'Anthropic fait passer les skills d'entreprise avant les skills personnels, et les personnels avant ceux du projet ; au moins un guide bien placé sur cette question affirme l'inverse, ce que la documentation contredit.

Les skills d'un projet se chargent aussi quand vous lancez Claude Code dans un sous-dossier : il lit .claude/skills/ dans le dossier de départ et dans chaque dossier parent jusqu'à la racine du dépôt. Les sessions dans le cloud chargent les skills de projet versionnés dans le dépôt, jamais votre dossier personnel.

Où se trouve le dossier des skills Claude sur Mac, Windows et Linux ?

Claude Code range les skills personnels dans un dossier .claude de votre répertoire personnel, quel que soit le système : ~/.claude/skills/ sur macOS et Linux, %USERPROFILE%\.claude\skills\ sur Windows, où la documentation d'Anthropic indique que ~/.claude se résout en %USERPROFILE%\.claude. Les skills importés dans Claude.ai, le chat de Claude Desktop ou Cowork sont gardés dans votre compte, pas dans un dossier de votre ordinateur.

Si la variable d'environnement CLAUDE_CONFIG_DIR est définie, tous les chemins en ~/.claude passent sous ce répertoire. Dans Claude Code, /skills liste ce qui est chargé, quel que soit le dossier.

Sur Mac, le nom du dossier commence par un point : le Finder le masque. Ouvrez-le depuis le Terminal avec : open ~/.claude/skills

Certains guides donnent ~/Library/Application Support/Claude Code/skills/ sur macOS ou %APPDATA%\Claude Code\skills\ sur Windows. La documentation d'Anthropic ne cite pas ces chemins pour les skills ; elle donne ceux du tableau.

Comment installer un skill Claude depuis GitHub ?

Tout dépend de ce que contient le dépôt. Si c'est une marketplace de plugins (il contient un fichier .claude-plugin/marketplace.json), ajoutez-la une fois dans Claude Code puis installez-en les plugins. S'il ne contient que des dossiers de skills, copiez le dossier voulu dans votre répertoire de skills. Dans les deux cas, lisez le skill avant de l'installer : c'est du code écrit par quelqu'un d'autre.

1. Marketplace de plugins, dans Claude Code : lancez /plugin marketplace add proprietaire/depot, puis /plugin install <plugin>@<marketplace>, où <marketplace> est le nom sous lequel la marketplace s'est enregistrée. Dans une session, la commande d'installation ouvre d'abord la fiche du plugin, pour le relire et choisir sa portée.
2. La même chose depuis votre shell, sans ouvrir de session : claude plugin marketplace add proprietaire/depot, puis claude plugin install <plugin>@<marketplace>.
3. Simples dossiers de skills : clonez le dépôt où vous voulez, puis copiez le dossier qui contient SKILL.md dans ~/.claude/skills/ ou .claude/skills/. Cloner tout un dépôt directement dans ~/.claude/skills/ ne marche que si SKILL.md est à la racine du dépôt ; sinon le skill se retrouve un niveau trop bas, là où Claude Code ne cherche pas.
4. Pour mettre à jour un skill cloné avec git pull, faites un lien plutôt qu'une copie : un dossier de skill à l'emplacement personnel ou projet peut être un lien symbolique vers un répertoire situé ailleurs sur le disque.
5. Pour Claude.ai, le chat de Desktop ou Cowork : téléchargez le dossier du skill, compressez-le en ZIP avec le dossier lui-même à la racine, et importez-le comme décrit dans la section suivante.

# Le dépôt de skills d'Anthropic est une marketplace de plugins :
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

• Découvrir et installer des plugins : La page d'Anthropic sur /plugin marketplace add, /plugin install et leurs équivalents en ligne de commande.
• anthropics/skills sur GitHub : Les skills d'exemple d'Anthropic, installables comme marketplace.

Les installeurs comme npx skills add sont des outils tiers, absents de la documentation d'Anthropic. Quoi qu'ils fassent, Claude Code charge les skills depuis les emplacements que documente Anthropic (le tableau ci-dessus) ou depuis un plugin activé.

Comment importer un skill dans Claude.ai, Claude Desktop (chat) et Cowork ?

Ici, un skill s'importe dans votre compte, il ne se copie pas dans un dossier de votre machine. Les intitulés ci-dessous sont ceux du centre d'aide en français, qui appelle les skills des « compétences » ; entre parenthèses, ceux de l'application en anglais. L'application en français peut employer d'autres mots.

1. Activez l'exécution de code. Sur les offres Free, Pro et Max : Paramètres > Capacités (Settings > Capabilities), puis activez « l'exécution de code et la création de fichiers » (Code execution and file creation). Sur Team et Enterprise, un propriétaire active l'exécution de code et les compétences dans Paramètres de l'organisation > Plugins et compétences (Organization settings > Plugins & skills), onglet « Politique » (Policy).
2. Ouvrez Personnaliser > Compétences (Customize > Skills), appuyez sur le bouton « + », puis sur « + Créer une compétence » (+ Create skill) et « Télécharger une compétence » (Upload a skill).
3. Choisissez le ZIP d'un seul skill. Importez les skills un par un : une archive qui contient plusieurs dossiers de skills n'est pas un skill et ne se chargera pas comme tel.
4. Le centre d'aide demande un ZIP dont la racine est le dossier du skill, et présente des fichiers posés en vrac à la racine du ZIP comme la mauvaise structure. Un fichier .skill est une archive ZIP construite ainsi. Si le sélecteur de fichiers refuse l'extension .skill, faites-en une copie et renommez-la en .zip.

Cowork et les sessions dans le cloud ne lisent pas ~/.claude/skills/ sur votre machine. Ils chargent les skills activés sur votre compte.

Sur Team et Enterprise, un propriétaire peut désactiver la création de skills par les utilisateurs. Si l'option pour créer ou importer un skill n'apparaît pas, c'est la première question à lui poser.

Comment utiliser un skill une fois installé, et pourquoi ne se déclenche-t-il pas ?

Vous n'avez pas à appeler un skill par son nom. Claude lit la description de chaque skill et charge le bon d'après vos mots : « audite mon site » suffit pour qu'un skill d'audit réponde.

Dans Claude Code, vous pouvez aussi appeler un skill directement, avec une barre oblique et le nom de son dossier, par exemple /site-xray.

Un skill qui ne se déclenche jamais est en général chargé mais pas choisi : sa description ne correspond pas aux mots que vous avez employés. Appelez-le une fois par son nom, ou dites ce que vous voulez dans les termes de sa description.

• Site X-Ray : Le skill pris en exemple sur cette page.

Pourquoi mon skill Claude n'apparaît-il pas ou ne se charge-t-il pas ?

1. Vérifiez le nom du dossier. Le dossier d'un skill doit garder le nom sous lequel il est livré : c'est celui écrit dans son SKILL.md. Le centre d'aide cite un nom de dossier qui ne correspond pas au nom du skill parmi les erreurs d'import.
2. Vérifiez que l'exécution de code est activée, dans les applications. Sans elle, la section des skills peut manquer ou rester grisée, et un skill livré avec des scripts ne peut suivre que sa procédure manuelle, s'il en a une.
3. Vérifiez le ZIP, dans les applications. Les autres causes d'échec que cite le centre d'aide : un ZIP au-delà de la taille permise, un SKILL.md manquant, des caractères non valides dans le nom ou la description.
4. Vérifiez la longueur de la description. La spécification Agent Skills et la documentation de la plateforme d'Anthropic admettent 1 024 caractères. Un article du centre d'aide donne une limite plus courte (200 caractères) : si un import est refusé ou tronqué pour cette raison, c'est la description qu'il faut regarder en premier.
5. Dans Claude Code, lancez /skills. Si le skill n'y figure pas, lancez /reload-skills ou redémarrez la session. Un nom de dossier qui contient un caractère invisible (espace insécable, espace de largeur nulle, < ou >) est refusé : lancez claude --debug et cherchez [names] dans le journal de débogage.

Avant d'installer un skill, quel qu'il soit

Un skill peut contenir des scripts, et des scripts exécutent du code dans votre environnement Claude ou sur votre machine. Lisez le SKILL.md et regardez les scripts avant d'installer le skill de quelqu'un que vous ne connaissez pas. Le centre d'aide d'Anthropic dit la même chose : n'installez des skills que de sources de confiance, et relisez d'abord les fichiers fournis, les dépendances de code et toute instruction qui ferait appel à une source réseau externe.

Les 14 skills de ce pack utilisent du Python standard, version 3.9 ou plus récente, sans rien à installer, et sont livrés avec un fichier de sommes de contrôle et un petit vérificateur : python3 verify_pack.py vous dit si votre exemplaire est bien celui qui a été publié.

• Peut-on faire confiance aux skills Claude d'éditeurs indépendants ? : les contrôles à faire avant d'installer un skill