Ajoutez des capacités réutilisables à vos agents IA avec skills.sh

May 3, 2026 · 4 min read

Ajoutez des capacités réutilisables à vos agents IA avec skills.sh

Chaque fois que vous démarrez une nouvelle conversation avec un agent de codage IA, vous repartez de zéro. L’agent ne connaît ni la structure de vos dossiers, ni vos conventions de nommage de composants, ni les règles de déploiement de votre équipe. Vous collez le même bloc de contexte une fois de plus. Vous réexpliquez les mêmes contraintes. C’est fastidieux, et cela ne passe pas à l’échelle.

skills.sh propose une solution concrète : un écosystème grandissant de capacités d’agent réutilisables, à installer une seule fois et à utiliser dans tous les agents et projets compatibles.

Points clés à retenir

Les skills d’agent sont des ensembles d’instructions réutilisables, chargés à la demande, définis par un fichier SKILL.md comportant un frontmatter YAML et un corps en Markdown.
La divulgation progressive (progressive disclosure) maintient les fenêtres de contexte légères en chargeant d’abord uniquement les noms et descriptions des skills, puis en récupérant les instructions complètes seulement lorsqu’elles sont pertinentes.
L’interface en ligne de commande skills vous permet d’installer, de cibler et de rechercher des skills entre projets sans écrire de code d’intégration personnalisé.
Les skills se distinguent des serveurs MCP : utilisez les skills pour des workflows reproductibles basés sur des prompts, et MCP pour des interactions typées, de type API, avec des systèmes externes.
Inspectez toujours les skills tiers — surtout ceux contenant des scripts — avant de les installer, car ils peuvent s’exécuter dans votre environnement local selon la configuration de votre agent.

Que sont les skills d’agent IA ?

Un skill d’agent est un ensemble structuré d’instructions qu’un agent IA peut charger à la demande. Fondamentalement, chaque skill est un répertoire contenant un fichier SKILL.md avec un frontmatter YAML et un corps en Markdown :

my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable helpers
├── references/       # Optional: supplementary docs
└── assets/           # Optional: templates, configs

Le frontmatter requiert au minimum deux champs :

---
name: react-component-review
description: Reviews React components for performance issues, accessibility, and team conventions. Use when the user asks to review, audit, or check a component.
---

Le champ name doit correspondre au nom du répertoire (en minuscules, avec uniquement des tirets). La description est ce que l’agent utilise pour décider d’activer ou non le skill — considérez-la comme une règle de routage, et non comme un titre.

Comment la divulgation progressive maintient le contexte léger

C’est le mécanisme qui rend les skills viables à grande échelle. Les agents ne chargent pas tout le contenu des skills d’emblée. Ils suivent plutôt trois étapes :

Découverte — Au démarrage, seuls name et description sont chargés dans la conscience de l’agent.
Activation — Lorsqu’une requête utilisateur correspond sémantiquement à la description d’un skill, l’agent lit le corps complet du fichier SKILL.md.
Exécution — Les scripts ou fichiers de référence à l’intérieur du skill ne sont récupérés que si les instructions le demandent.

Cela signifie que vous pouvez enregistrer des dizaines de skills sans surcharger la fenêtre de contexte à chaque requête.

Installer des skills avec le CLI Skills

Le CLI skills est l’interface principale pour gérer les skills d’agent. Vous n’avez aucune intégration à construire — il suffit d’exécuter :

npx skills add vercel-labs/agent-skills

Les options courantes que vous utiliserez réellement :

# Install globally across all projects
npx skills add -g vercel-labs/agent-skills

# Install only specific skills from a repo
npx skills add vercel-labs/agent-skills --skill frontend-design

# List what's available before installing
npx skills add vercel-labs/agent-skills --list

# Search the ecosystem
npx skills find typescript

Les skills peuvent être installés à l’échelle du projet (versionnés avec votre dépôt, partagés avec votre équipe) ou globalement pour votre usage personnel. Le CLI prend également en charge les chemins locaux et les URL Git complètes.

Skills vs. serveurs MCP et plugins

Les skills ne sont pas équivalents aux serveurs MCP ou aux plugins d’agent. Les serveurs MCP exposent des outils typés que les agents appellent avec des entrées et des sorties structurées — ils conviennent lorsque vous avez besoin d’un contrôle strict, de style API, sur des systèmes externes. Les skills sont plus simples : ce sont de simples instructions Markdown qui guident le comportement de l’agent sans nécessiter d’infrastructure serveur.

Utilisez un skill lorsque vous avez un workflow reproductible qui réside actuellement dans un prompt que vous copiez-collez. Utilisez MCP lorsque vous avez besoin que l’agent interagisse avec une API externe de manière contrôlée et typée.

⚠️ Une note sur la sécurité

Les skills ne sont pas vérifiés par défaut. La plateforme skills.sh effectue des audits périodiques, mais elle ne peut garantir la sûreté de chaque skill publié. Avant d’installer un skill tiers — surtout s’il inclut un répertoire scripts/ — lisez-le. Selon votre agent ou votre runtime, les scripts peuvent s’exécuter dans votre environnement local sans sandboxing.

Le standard émergent des Agent Skills

Le format Agent Skills est né avec Claude, mais il est désormais documenté indépendamment sur agentskills.io et pris en charge par plusieurs plateformes, notamment OpenAI Codex, Spring AI et la chaîne d’outils de Vercel. Il s’agit d’une convention en cours de convergence, pas encore d’un standard finalisé — mais la structure de base (SKILL.md, frontmatter YAML, répertoires de support optionnels) est suffisamment stable pour être adoptée.

Conclusion

Si vous passez du temps à réexpliquer le même contexte de projet à votre agent de codage, les skills sont l’outil qu’il vous faut. Ils transforment des prompts copiés-collés en ressources versionnées et partageables qui ne se chargent qu’au besoin, gardant le contexte de votre agent léger et votre workflow cohérent. Commencez par npx skills init pour échafauder votre premier skill, ou parcourez skills.sh pour en trouver un qui couvre déjà votre workflow.

FAQ

Vous avez besoin d'un agent ou d'un client qui prend en charge la convention Agent Skills. Le format en lui-même n'est que du Markdown avec un frontmatter YAML, mais il ne fonctionne que si votre outillage implémente le modèle de découverte et d'activation. Claude a introduit le concept, et des outils comme la chaîne d'outils de Vercel, Spring AI et OpenAI Codex le prennent désormais en charge.

Un prompt système est toujours chargé et s'applique à chaque requête, ce qui consomme du contexte à chaque tour. Un skill n'est chargé que lorsque sa description correspond à l'intention de l'utilisateur. Cette activation sélective vous permet de maintenir des dizaines de comportements spécialisés sans payer le coût en tokens d'emblée, rendant les skills plus évolutifs que des prompts monolithiques.

Oui. Le CLI skills accepte les chemins locaux et les URL Git complètes, vous pouvez donc héberger des skills dans un dépôt privé et les installer de la même manière qu'un dépôt public. Les skills à portée de projet peuvent également être versionnés directement dans votre base de code, ce qui les conserve aux côtés du projet qu'ils supportent.

L'agent décide quel skill activer en fonction de la similarité sémantique avec la requête de l'utilisateur, de sorte que des descriptions qui se chevauchent peuvent entraîner un routage imprévisible. Rédigez les descriptions comme des règles de routage précises — mentionnez les déclencheurs exacts, les types de fichiers ou la formulation utilisateur. Si deux skills se chevauchent réellement, envisagez de les fusionner ou de restreindre la portée de l'un pour éviter les conflits.

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.