Guide

skills.sh : installer des skills sur tous vos agents de codage IA

Utilisez la CLI skills.sh pour installer et maintenir des skills d’agent pour Codex, Claude Code et d’autres agents de codage, sans dupliquer vos instructions.

Si vous utilisez plusieurs agents de codage, copier les mêmes instructions dans des répertoires distincts pour Claude Code, Codex, Cursor et OpenCode tourne vite au désordre. Chaque copie peut diverger, et il devient difficile de savoir quelle version un agent est en train de suivre.

skills.sh propose un annuaire pour découvrir des skills d’agent. Sa CLI skills, open source, se charge de la partie pratique : sélectionner des skills dans un dépôt, les installer pour un ou plusieurs agents, puis les mettre à jour ou les supprimer.

Réponse rapide

Commencez par lister les skills d’un dépôt sans rien installer :

npx skills add vercel-labs/agent-skills --list

Installez ensuite un skill pour les agents qui doivent l’utiliser :

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent claude-code \
  --agent codex

Pour rendre ce skill précis disponible pour toutes les cibles d’agents prises en charge par la CLI, utilisez un joker entre guillemets afin que le shell ne le développe pas :

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent '*'

Il existe aussi une commande beaucoup plus large :

npx skills add vercel-labs/agent-skills --all

--all signifie tous les skills détectés et tous les agents, sans demande de confirmation. C’est pratique pour un dépôt qui vous appartient et que vous avez examiné. C’est généralement trop large pour essayer une collection publique que vous ne connaissez pas.

Ce qui est installé

Un skill d’agent est un répertoire qui contient au moins un fichier SKILL.md. Ce fichier comporte un nom, une description qui aide l’agent à décider quand l’activer, et les instructions à suivre. Un skill peut aussi contenir des scripts exécutables, de la documentation de référence et des ressources. La structure complète est décrite dans la spécification Agent Skills.

La CLI skills connaît les répertoires de projet et les répertoires globaux utilisés par des dizaines d’agents de codage. Par exemple, elle cible .agents/skills/ pour une installation Codex au niveau du projet et .claude/skills/ pour Claude Code. Elle peut créer des liens symboliques depuis ces répertoires d’agents vers une copie de référence unique du skill. Les instructions restent ainsi cohérentes, et une seule mise à jour sert plusieurs agents.

Utilisez --copy quand les liens symboliques ne conviennent pas au système de fichiers ou à l’environnement de déploiement. Les copies sont indépendantes : c’est alors à vous de maintenir tous les agents sur la même version.

Choisir sciemment la portée projet ou globale

L’installation par défaut est locale au projet. Lancez la commande depuis la racine du projet quand un skill encode des conventions du dépôt, des versions de framework ou un workflow que l’équipe doit pouvoir examiner.

N’ajoutez --global (ou -g) que pour un workflow personnel qui doit s’appliquer à tous vos projets :

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent codex \
  --global

Les skills locaux au projet sont plus faciles à relire à côté du code qu’ils concernent. Les skills globaux réduisent les répétitions, mais ils peuvent aussi amener deux développeurs à obtenir des comportements d’agent différents à partir du même dépôt. Documentez tout skill global dont dépend un workflow partagé.

Voir l’annuaire comme un outil de découverte, pas comme une preuve de qualité

Le classement de skills.sh repose sur la télémétrie anonyme des installations remontée par la CLI. Un nombre d’installations peut témoigner d’un intérêt, mais il ne démontre pas qu’un skill améliore les résultats, qu’il est à jour ou qu’il convient à votre projet.

Avant d’installer un skill public :

  1. Ouvrez son dépôt source et lisez SKILL.md en entier.
  2. Examinez les fichiers référencés et chaque script que le skill peut exécuter.
  3. Vérifiez sa licence, la récence de sa maintenance, ses dépendances, ses accès réseau et ses notes de compatibilité.
  4. Repérez les instructions qui entrent en conflit avec les versions de votre projet ou avec les règles existantes de votre AGENTS.md.
  5. Essayez-le sur un seul projet et une tâche reproductible avant de le rendre global ou de l’installer pour tous les agents.

skills.sh indique effectuer des audits de sécurité réguliers, mais précise aussi ne pas pouvoir garantir chaque skill référencé. C’est la bonne hypothèse à retenir. Un skill, ce sont des instructions — et parfois du code — provenant d’un autre dépôt, pas un bac à sable ni une décision de confiance.

La télémétrie anonyme de la CLI peut être désactivée pour une commande avec la variable d’environnement documentée :

DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills --list

Plus de skills ne rend pas forcément un agent meilleur

Installer un skill n’augmente pas les capacités fondamentales du modèle de base. Cela lui fournit des instructions et des ressources supplémentaires. Des instructions utiles peuvent rendre un workflow spécialisé plus fiable ; des instructions hors sujet ou obsolètes peuvent consommer du contexte, brider une bonne approche ou entrer en conflit avec le dépôt.

Les premiers résultats sont mitigés. Un benchmark récent de skills d’ingénierie logicielle n’a relevé qu’une amélioration moyenne de 1,2 % sur 49 skills publics. Trente-neuf n’ont montré aucune amélioration du taux de réussite, et trois l’ont même fait baisser. Une étude SkillsBench plus large a constaté un gain moyen substantiel dans plusieurs domaines, mais aussi des résultats négatifs sur certaines tâches, et de meilleures performances avec des skills ciblés qu’avec une documentation exhaustive.

Ce sont deux prépublications récentes, pas un verdict définitif. La leçon pratique reste utile : évaluez un skill sur la même tâche avec et sans lui. Gardez-le si le résultat est plus correct, plus reproductible ou plus facile à maintenir — pas simplement parce que l’agent a produit une réponse plus longue.

Utiliser le mécanisme le plus léger qui résout le problème

Besoin Meilleur point de départ
Procédure reproductible, propre à un outil, avec des fichiers d’appui Un skill de projet ciblé
Workflow personnel utilisé dans de nombreux dépôts Un seul skill global, examiné
Règles que chaque contributeur et chaque agent doivent toujours suivre Des instructions de projet versionnées, comme AGENTS.md
Une tâche inhabituelle Un prompt direct avec le contexte nécessaire
Une politique ou une vérification déterministe Un script, un test, un formateur ou une règle de CI
Des consignes anciennes, génériques ou contradictoires Aucun skill tant que les consignes ne sont pas corrigées

Cette distinction évite qu’une bibliothèque de skills ne devienne un second système de configuration, moins visible. Les skills sont surtout utiles pour des connaissances procédurales qu’un agent ne doit charger que lorsqu’une tâche correspondante se présente. Les commandes et les limites durables, valables pour tout le dépôt, ont leur place dans un fichier d’instructions ciblé ; voir que mettre dans AGENTS.md et CLAUDE.md pour les données disponibles et un modèle compact.

Garder les skills installés maintenables

La CLI fournit les commandes habituelles de gestion du cycle de vie :

# Show project and global skills
npx skills list

# Update one installed skill
npx skills update web-design-guidelines

# Remove it
npx skills remove web-design-guidelines

Examinez les changements en amont avant de mettre à jour un skill utilisé en production ou par toute une équipe. Si la reproductibilité compte, consignez la source et la révision examinée dans la documentation du projet, comme vous le feriez pour n’importe quel autre outil de développement.

Le choix raisonnable par défaut est restreint : installez un skill examiné, dans un seul projet, pour les agents qui en ont besoin. N’élargissez à --agent '*', à la portée globale ou à --all qu’une fois que le workflow a mérité cette portée.

Questions fréquentes

skills.sh peut-il installer un même skill pour Codex et pour Claude Code ?

Oui. Passez les deux noms d’agents à la CLI skills, par exemple --agent codex --agent claude-code. La CLI installe une copie de référence et peut la lier dans le répertoire de skills attendu par chaque agent.

Comment installer un skill pour tous les agents pris en charge ?

Utilisez --agent '*' avec un --skill précis. L’option plus large --all installe tous les skills détectés pour tous les agents, sans demande de confirmation : examinez donc la source avant de l’utiliser.

Les skills de skills.sh sont-ils sûrs à installer ?

Pas automatiquement. skills.sh effectue des audits de sécurité, mais ne garantit explicitement ni la qualité ni la sécurité de chaque skill. Lisez SKILL.md, les scripts, les références, les dépendances et les accès demandés avant l’installation.

Partager ce guide