Résoudre la fragmentation des compétences d'agents via npx skills

Si vous utilisez plusieurs agents IA ou interfaces en ligne de commande (CLIs) sur votre machine — que ce soit Hermes, Claude Code, Codex, Antigravity, Kimi ou d'autres outils compatibles —, vous avez probablement déjà rencontré ce problème frustrant : la fragmentation des compétences (skills). Chaque agent ou CLI gère son propre dossier skills indépendant, ce qui entraîne des installations en doublon, des dérives de versions et une surcharge de maintenance.

Dans le cadre de nos travaux avec les agents IA, nous étions constamment confrontés aux limites suivantes :

• Multiplication des installations : Devoir installer une nouvelle compétence pour un agent, puis la réinstaller encore et encore pour tous les autres.
• Dérive des versions (version drift) : Personnaliser ou corriger une compétence pour un agent, oublier de mettre à jour les autres, et se retrouver avec des agents aux comportements incohérents.
• Gestion fastidieuse des compétences : Devoir inspecter chaque dossier skills de chaque agent sur l'ensemble du système pour savoir quelles compétences étaient réellement disponibles.

La CLI npx skills, un outil open-source créé par Vercel, résout ce problème en vous permettant de gérer un dossier skills unique et centralisé, partagé de manière transparente par tous vos agents. N'hésitez pas à consulter le dépôt GitHub de npx skills.

Un dossier centralisé

Le concept est d'une grande simplicité : si nous faisons pointer le dossier skills de chaque agent vers le même dossier physique, le problème de la fragmentation disparaît instantanément.

Lorsque vous installez une compétence avec la CLI npx skills, celle-ci est téléchargée dans le dossier centralisé de votre machine (~/.agents/skills). La CLI crée ensuite un lien symbolique (un symlink, qui agit comme un pointeur transparent) reliant le dossier skills de chaque agent à ce dossier centralisé.

Par exemple, lorsque Claude Code recherche ses compétences dans ~/.claude/skills/, il est redirigé de manière invisible vers ~/.agents/skills. Si vous ajustez une compétence dans ce dossier centralisé, absolument tous vos agents bénéficient immédiatement de la mise à jour. Finies les copies manuelles, les scripts de synchronisation complexes et le gaspillage d'espace disque !

Installer npx skills et ajouter une compétence

Lancez la commande suivante pour commencer et ajouter votre toute première compétence :

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

La CLI vous demandera si vous souhaitez effectuer cette configuration pour un projet spécifique ou de manière globale. Nous vous recommandons généralement de choisir l'option global pour que tous vos agents compatibles puissent y accéder d'un coup :

Ensuite, veillez à bien sélectionner Symlink pour garantir une source unique de vérité :

Une fois l'opération terminée, nous pouvons vérifier que la compétence est bien installée dans le dossier centralisé à l'emplacement ~/.agents/skills :

Lancez maintenant la CLI de Kimi (or tout autre agent) : la compétence excalidraw-diagram est disponible et prête à l'emploi !

Créer une compétence à partir de zéro

Pour concevoir vos propres compétences sur mesure, vous pouvez utiliser l'outil skill-creator d'Anthropic. Installez-le comme suit :

npx skills add https://github.com/anthropics/skills --skill skill-creator

Ensuite, dans Kimi ou tout autre agent, saisissez le prompt suivant :

Use the skill-creator to help me build a skill for creating a product landing page

Kimi (ou votre agent) détectera automatiquement skill-creator et vous guidera étape par étape dans sa création :

Autres commandes utiles de npx skills

Voici d'autres commandes très pratiques :

• npx skills ls -g : Lister toutes les compétences installées globalement
• npx skills update : Mettre à jour toutes vos compétences en une seule commande
• npx skills remove : Désinstaller ou supprimer une compétence de manière interactive

Veuillez vous référer au dépôt GitHub de npx skills pour découvrir d'autres commandes et ressources.

Aller encore plus loin

Puisque toutes vos compétences sont désormais réunies au même endroit (~/.agents/skills), vous pouvez l'initialiser en tant que dépôt Git et le pousser vers GitHub ou GitLab.

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

Désormais, vous disposez d'un historique complet de toutes les modifications apportées à vos compétences, ce qui vous permet de revenir facilement en arrière en cas de problème. De plus, vous pouvez synchroniser sans effort vos compétences sur plusieurs machines (par exemple, entre votre ordinateur portable et votre poste fixe) avec un simple git pull.

Quelques points de vigilance (Sécurité et risques)

• Compatibilité variable : Toutes les plateformes d'agents ne prennent pas encore en charge l'ensemble des fonctionnalités (comme les hooks personnalisés ou des autorisations d'outils spécifiques). Une compétence peut parfaitement fonctionner avec un agent et présenter des limites avec un autre.
• Confiance des sources : N'installez que des compétences provenant de sources fiables.
• Vérification du code : Si vous utilisez une compétence tierce ou personnalisée, examinez attentivement ses fichiers (notamment le dossier scripts/) avant d'autoriser votre agent à l'exécuter.
• Principe de moindre privilège : Évitez de donner à une compétence plus de permissions ou d'accès aux outils que ce qui est strictement nécessaire à son fonctionnement.
• Ne stockez jamais de secrets en dur : Gardez vos clés d'API et autres secrets confidentiels en dehors des fichiers de compétences.

Mettre en place une "source unique de vérité" centralisée à l'aide de npx skills a épargné bien des frustrations et des tâches redondantes à notre équipe. Nous vous conseillons vivement d'essayer : la puissance de l'IA grandit à mesure que s'enrichissent vos compétences !