Skills · 11 min
Choisir, vérifier et installer un skill Claude sans te faire piéger
Un skill, c'est du texte plus parfois du code qui tourne sur ta machine, avec les mêmes accès que n'importe quel programme que tu installes. Presque personne ne les lit avant de cliquer.
Ce qu’il y a dedans
- Les 3 trucs, en résumé
- Truc 1 : un skill, c'est pas un prompt
- Truc 2 : environ un skill sur trois trimballe une faille
- La routine de vérification en 5 minutes
Un skill, c'est du texte plus parfois du code qui tourne sur ta machine, avec les mêmes accès que n'importe quel programme que tu installes. Presque personne ne les lit avant de cliquer. Voilà les 3 choses à savoir, et la routine de vérification qui prend 5 minutes.
Les 3 trucs, en résumé
- Un skill n'est pas un prompt. C'est un dossier avec des instructions et du code que Claude exécute tout seul.
- Environ un skill sur trois du catalogue public traîne un problème de sécurité. Un audit Snyk de février 2026 l'a chiffré sur près de 4 000 skills.
- Un mauvais skill dégrade Claude au lieu de l'améliorer, dans environ un cas sur quatre. Et tu ne peux pas le repérer en le lisant.
Le reste du document détaille chaque point, avec la méthode concrète derrière.
Truc 1 : un skill, c'est pas un prompt
Un prompt, c'est une consigne que tu tapes dans une conversation. Elle vit le temps de l'échange, puis elle disparaît.
Un skill, c'est un dossier sur ton disque. Dedans, un fichier SKILL.md obligatoire, et à côté, ce que l'auteur veut y mettre : d'autres fichiers de documentation, des scripts Python ou shell, des modèles de documents, des données de référence.
Sur Claude Code, ces dossiers vivent à deux endroits :
- ~/.claude/skills/ pour tes skills personnels, disponibles partout
- .claude/skills/ à la racine d'un projet, disponibles uniquement dans ce projet
Le fichier SKILL.md commence par un petit en-tête avec deux champs obligatoires, name et description :
---
name: analyse-factures
description: Extrait les montants, dates et fournisseurs d'une facture PDF. À utiliser quand l'utilisateur parle de factures, de comptabilité ou d'extraction de montants.
---
Cette description est la pièce la plus importante du fichier, et c'est ce que la plupart des gens sous-estiment. C'est elle que Claude compare à ta demande pour décider s'il déclenche le skill ou pas. Elle doit dire ce que fait le skill et quand s'en servir.
Le chargement en trois temps
Claude ne charge pas tout d'un coup. Il procède par paliers, ce qui explique pourquoi tu peux installer beaucoup de skills sans exploser ton contexte :
Le palier 3 est celui qui compte pour la suite de ce guide. Quand les instructions mentionnent un script, Claude le lance via le terminal et ne récupère que le résultat. Le code du script n'entre jamais dans la conversation. Tu ne le vois pas passer.
C'est ce qui rend les skills puissants : Claude agit au lieu de conseiller. Tu ne lui expliques pas comment traiter une facture, tu lui branches la procédure et l'outillage. L'équivalent business, c'est la différence entre expliquer ton métier à un stagiaire chaque matin et recruter quelqu'un qui arrive avec sa méthode et ses outils.
C'est aussi ce qui les rend risqués. On y arrive.
Truc 2 : environ un skill sur trois trimballe une faille
En février 2026, les chercheurs de Snyk ont passé au scanner 3 984 skills récupérés sur ClawHub et skills.sh, les deux gros catalogues publics. Le résultat, publié sous le nom ToxicSkills :
- 36,8 % des skills (1 467) présentent au moins un problème de sécurité, toutes gravités confondues
- 13,4 % (534) ont au moins un problème de niveau critique : malware, injection d'instructions, secrets exposés
- 10,9 % contiennent des identifiants ou clés écrits en dur dans le code
- 76 charges malveillantes ont été confirmées à la main, dont 8 étaient encore en ligne le jour de la publication
Et ce n'est pas resté théorique. En février 2026 toujours, les chercheurs d'OpenSourceMalware.com ont documenté la première campagne coordonnée visant les utilisateurs de Claude Code : plus de 30 skills piégés distribués sur ClawHub, avec vol d'identifiants, installation de porte dérobée et exfiltration de données.
Pourquoi ça marche si bien
Deux mécanismes, tous les deux discrets.
Le premier, c'est le code que tu ne lis pas. Tu ouvres le SKILL.md, il a l'air propre. Le install.sh ou le helper.py posé à côté, tu ne l'as jamais ouvert. C'est pourtant lui qui s'exécute.
Le second, c'est l'injection d'instructions. Le skill contient des consignes cachées qui ne s'adressent pas à toi mais à Claude : va lire ce fichier, envoie ce contenu à cette adresse. Snyk a trouvé cette technique dans 91 % des skills malveillants confirmés.
Un point de la documentation Anthropic mérite d'être lu deux fois : sur l'API, les skills tournent dans un bac à sable sans accès réseau. Sur Claude Code, un skill a exactement le même accès réseau que n'importe quel programme sur ta machine. Pas de bac à sable par défaut, pas de signature cryptographique pour vérifier l'auteur, pas de revue de sécurité automatique avant publication.
La consigne officielle d'Anthropic est claire : traite un skill tiers comme du code qu'on t'envoie, et lis-le avant de l'activer.
La routine de vérification en 5 minutes
C'est la partie qui t'évite de faire partie des statistiques.
Prérequis
Savoir ouvrir un terminal, et connaître les deux chemins vus plus haut. C'est tout.
Étape 1 — Ne jamais installer depuis un lien qu'on t'a envoyé
Un skill qui arrive par message privé, par un commentaire ou dans un fil de discussion, tu ne l'installes pas parce que la personne a l'air sérieuse. Tu récupères le dossier, tu le regardes, ensuite tu décides.
Étape 2 — Lister tous les fichiers, pas seulement le SKILL.md
ls -R ~/.claude/skills/nom-du-skill
Si tu vois des fichiers .sh, .py, .js ou des binaires sans extension, ce sont eux qu'il faut ouvrir en priorité. Un skill qui n'annonce que de la documentation et qui embarque un exécutable, c'est déjà une question à poser.
Étape 3 — Chercher les motifs qui posent problème
grep -rniE "curl|wget|https?://|\.env|\.aws|\.ssh|bashrc|zshrc|base64" ~/.claude/skills/nom-du-skill
Cette commande remonte les appels réseau, les lectures de fichiers sensibles et le contenu encodé. Un skill de mise en forme de documents n'a aucune raison de lire ton ~/.ssh ni de contacter un serveur.
Étape 4 — Faire auditer le dossier par Claude lui-même
Colle ça dans une session Claude Code :
Lis tous les fichiers du dossier ~/.claude/skills/nom-du-skill.
Dis-moi précisément : quels fichiers s'exécutent, quelles commandes shell
ils lancent, quelles URL ils contactent, et quels fichiers en dehors du
dossier ils touchent. Ne résume pas, liste.
Tu obtiens en 30 secondes une cartographie que tu mettrais 20 minutes à faire à la main.
Étape 5 — Installer au niveau projet, pas en global
Un skill posé dans ~/.claude/skills/ est actif dans tous tes projets, y compris ceux où tu as des données clients. Un skill que tu testes, tu le mets d'abord dans .claude/skills/ d'un projet vide. S'il se comporte bien pendant une semaine, tu le promeus.
C'est la même logique que donner les accès à une nouvelle recrue : on commence par le périmètre minimum.
5 signaux d'alerte à chercher dans un skill
- Une section « Prérequis » qui te demande de coller une commande. C'est exactement le vecteur utilisé par la campagne ClawHavoc : le SKILL.md est propre, mais il t'invite à télécharger une archive ou à exécuter une ligne récupérée sur un site externe. Aucun skill légitime n'a besoin que tu colles une commande venue d'ailleurs.
- Un fichier exécutable qui n'est pas mentionné dans la documentation. Si le SKILL.md parle de trois scripts et que le dossier en contient six, les trois autres sont le sujet.
- Une URL écrite en dur. Un skill qui va chercher ses instructions à distance peut changer de comportement après ton installation, sans que rien ne bouge sur ton disque. C'est le cas le plus vicieux, parce que ta vérification initiale reste valable et le skill devient malveillant plus tard.
- Un accès à des fichiers hors périmètre. .env, ~/.aws, ~/.ssh, ~/.bashrc, ou la commande env toute seule qui liste tes variables d'environnement. Ce sont des endroits où vivent tes clés API. Un skill de rédaction n'y a rien à faire.
- Une description qui ne colle pas au contenu. Souviens-toi que la description est ce que Claude lit en permanence, dès le démarrage. C'est l'endroit le plus discret pour glisser une consigne qui n'a rien à voir avec la mission affichée. Compare toujours ce que le skill dit faire et ce que le dossier fait réellement.
Truc 3 : un mauvais skill rend Claude pire, et ça ne se lit pas
Celui-là est contre-intuitif, et c'est le plus utile à comprendre.
En mai 2026, Microsoft Research a publié SkillLens, une étude qui teste ce que les skills font réellement aux performances d'un agent. Le protocole couvre 5 domaines, 6 modèles cibles et 5 modèles générateurs, ce qui donne un grand nombre de combinaisons mesurées.
Le résultat principal : dans 25 % des combinaisons testées, ajouter le skill fait baisser le taux de réussite au lieu de le monter. Les chercheurs appellent ça le transfert négatif. Le taux varie beaucoup selon le domaine, d'environ 13 % sur les tâches de code et de tableur jusqu'à 47 % sur certaines tâches d'agent.
La seconde partie du résultat est celle qui fait mal. Les chercheurs ont demandé à un juge de dire, en lisant deux skills, lequel serait le plus performant. Le juge tombe juste 46,4 % du temps. C'est moins bien que de tirer à pile ou face. Pire, la précision baisse quand l'écart de performance réelle entre les deux skills augmente.
Traduit en clair : un skill bien écrit, bien structuré, agréable à lire, n'est pas un skill qui marche. La qualité apparente ne prédit pas la qualité réelle. Les auteurs le formulent comme ça : ce qui compte, ce sont des mécanismes d'échec précis avec des remèdes exécutables, pas des conseils génériques.
Empiler, c'est saboter
Un travail complémentaire, publié par Databricks (et non par Microsoft, les deux sont souvent confondus), mesure ce qui se passe quand on grossit la bibliothèque. En passant d'un petit lot de skills pertinents à une bibliothèque de 202 skills, le taux de réussite chute de 21 % en moyenne. La cause principale n'est pas la qualité des skills, c'est que des skills sémantiquement proches se font concurrence et que l'agent choisit le mauvais.
Donc installer 40 skills « au cas où » ne rend pas Claude plus fort. Ça lui donne plus d'occasions de se tromper d'outil.
La règle simple : un skill entre dans ta bibliothèque quand tu as une tâche récurrente précise qu'il traite. Pas parce qu'il avait l'air bien.
Mes 3 conseils avant d'installer ton prochain skill
- Teste avant/après sur ta propre tâche, pas sur la démo de l'auteur. Prends une tâche que tu fais vraiment, lance-la sans le skill, note le résultat. Installe, relance la même tâche. Si tu ne vois pas de différence nette, désinstalle. Vu les 25 % de transfert négatif, c'est le seul juge fiable, et ça prend dix minutes.
- Fais le ménage tous les mois. Ouvre ~/.claude/skills/, et pour chaque dossier pose-toi une question : est-ce que je l'ai utilisé ce mois-ci ? Si non, dehors. Tu réduis à la fois la surface d'attaque et la concurrence entre skills qui fait chuter les performances.
- Si un skill compte vraiment pour toi, optimise-le au lieu d'en chercher un autre. Un skill moyen sur ta tâche précise vaut souvent mieux qu'un skill brillant sur une tâche voisine, à condition de le retravailler avec tes propres exemples. (Voir lead magnet SKILLOPT pour la méthode automatisée, publiée par Microsoft aussi.)
Les limites à garder en tête
- Les chiffres Snyk datent de février 2026. Le scan porte sur l'état des catalogues à cette date. La proportion a pu bouger dans les deux sens depuis, les plateformes ayant réagi. Prends-le comme un ordre de grandeur, pas comme une mesure du jour.
- Faire auditer un skill par Claude a une faiblesse logique. Si le skill contient une injection d'instructions, tu demandes à Claude d'analyser un texte conçu pour manipuler Claude. Ça reste utile pour cartographier les fichiers et les commandes, c'est beaucoup moins fiable pour détecter une manipulation subtile. Les commandes ls -R et grep de l'étape 3 ne se font pas manipuler, elles.
- Les 25 % de SkillLens ne se lisent pas « un skill sur quatre que tu télécharges est mauvais ». L'étude porte sur des skills générés par des modèles, évalués sur des jeux de tests, et le chiffre est calculé sur des combinaisons modèle-générateur et modèle-cible. Ce que ça démontre solidement, c'est que le transfert négatif est fréquent et invisible à la lecture. Pas qu'un quart du catalogue public est nuisible.
- Aucune de ces vérifications ne remplace l'isolement. Si tu manipules des données clients ou des accès en production, la vraie réponse est de faire tourner l'agent dans un conteneur ou une machine dédiée. La revue manuelle réduit le risque, elle ne l'annule pas. (Sur l'approche sécurité offensive et l'audit d'agents, voir lead magnet SECU.)
Le mot de la fin
La bonne nouvelle, c'est que ces trois problèmes ont la même racine : on traite les skills comme des prompts, alors que ce sont des logiciels. Personne n'installerait un exécutable reçu par message privé sans regarder d'où il vient. C'est pourtant exactement ce qu'on fait avec les skills, parce que ça ressemble à du texte.
Change juste ce réflexe et tu élimines la majorité du risque. Un skill entre chez toi quand tu as ouvert son dossier, quand tu sais quels fichiers s'exécutent, et quand tu as une tâche précise à lui confier.
Ce soir, lance ls ~/.claude/skills/ et regarde la liste. Sur les skills que tu ne reconnais pas ou que tu n'as pas utilisés depuis un mois, passe la commande grep de l'étape 3. Compte cinq minutes. Tu vas probablement en désinstaller deux ou trois, et Claude ira mieux après.
