Compétence d'agent

Une compétence d'agent est un dossier d'instructions — en général un SKILL.md portant un nom, une description du moment où l'utiliser et la procédure elle-même — que l'agent découvre par sa description et ne charge que lorsque le travail l'exige.

6 min de lectureGEO / recherche IA

Ce que c'est, et pourquoi le chargement compte plus que le fichier

Tout ce qu'un agent sait dans une conversation doit tenir dans son contexte, et tout ce qui s'y trouve rivalise pour son attention. Coller votre charte, votre liste de relecture et votre procédure de déploiement dans chaque session, c'est la manière d'obtenir que le modèle ignore les trois : l'instruction qui compte est enfouie sous vingt qui ne comptent pas.

Une compétence renverse cela. L'agent ne voit que le nom et une ligne indiquant quand s'en servir — quelques dizaines de mots — et lit la procédure entière au moment où il juge que le travail s'applique. Ce qui n'est pas pertinent ne coûte rien : cent compétences peuvent exister sans le bruit de cent compétences. On appelle cela la divulgation progressive, et c'est tout le mécanisme.

Le format est volontairement ennuyeux : un fichier Markdown, des scripts et des références facultatifs à côté, un dossier lisible et versionnable. C'est parce que ce sont des fichiers ordinaires qu'elles sont relisables, comparables et partageables.

C'est une façon écrite de faire un travail, que l'agent saisit quand ce travail se présente.

Différence avec un prompt, un outil et un serveur MCP

Un prompt est ce que vous dites cette fois-ci. Une compétence est ce qui est vrai chaque fois que ce travail revient, écrit une fois et appliqué sans que personne pense à le coller.

Un outil est une capacité : quelque chose que l'agent peut faire. Une compétence est le jugement sur la manière de le faire : dans quel ordre, avec quelles vérifications, ce qui compte comme terminé, ce qu'il faut refuser.

Un serveur MCP donne à l'agent de la portée dans un système. Une compétence lui donne la maîtrise du travail. Elles se complètent, et le défaut de l'une sans l'autre est facile à imaginer : un agent branché sur votre base de données sans compétence écrira des requêtes qui s'exécutent et répondent à la mauvaise question.

Ce qui distingue une bonne compétence d'une longue

  • Une description qui dit quand s'en servir, pas ce que c'est. C'est la seule partie que l'agent lit avant de décider : « à utiliser pour relire une pull request dans ce dépôt » vaut mieux que « assistant de relecture de code ».
  • Un seul travail. Une compétence couvrant la relecture, la publication et le retour arrière est chargée pour les trois et précise pour aucune.
  • La procédure plutôt que la prose. Des étapes, des vérifications et des exemples traités survivent au fait d'être suivis ; un essai sur la qualité, non.
  • Les refus écrits. Ce qu'il ne faut pas faire, et quand s'arrêter pour demander, est ce qu'un modèle généraliste rate le plus souvent et ce que votre équipe sait.

Ce à quoi faire attention

  • Une compétence, ce sont des instructions que l'agent suivra. En installer une venue d'un inconnu revient à confier à son auteur tout ce que l'agent peut faire, et personne n'a audité ce texte entre-temps.
  • Les compétences vieillissent comme la documentation. Celle qui décrit le processus du trimestre passé sera suivie quand même, avec assurance, ce qui est pire que de n'en avoir aucune.
  • Plus n'est pas mieux. Des dizaines de descriptions qui se recouvrent rendent le choix plus difficile, et l'échec ressemble à un agent qui prend un voisin plausible plutôt que la bonne.
  • Une compétence ne répare pas un modèle qui n'a pas la capacité. Elle oriente la maîtrise ; elle ne la fournit pas.

Pourquoi cela figure dans un glossaire sur la visibilité

Parce que c'est le cas le plus net d'une écriture adressée à un lecteur machine qui reste de l'écriture. Une compétence est jugée sur les qualités mêmes qu'il faut à une page pour être citable : la première ligne dit-elle à quoi cela sert, l'utile est-il en haut, une étape peut-elle être extraite et appliquée sans le paragraphe qui l'entoure.

Il y a aussi un lien pratique. Le travail que vos acheteurs font avec des agents passe de plus en plus par des compétences publiées par quelqu'un, et ce que ces compétences disent d'une catégorie est un autre endroit où votre produit est décrit sans vous. C'est pour cela que nous tenons un répertoire public.

Questions fréquentes

Une compétence, est-ce la même chose qu'un GPT personnalisé ou une persona d'assistant ?

Non. Une persona est une consigne permanente qui façonne chaque réponse d'une session. Une compétence est chargée pour un type de travail et ignorée le reste du temps, ce qui permet à un agent de porter de nombreuses compétences et une seule persona sans qu'elles se contredisent.

Faut-il être développeur pour en écrire une ?

Non. Le cœur d'une compétence est un fichier Markdown décrivant comment un travail se fait correctement : ce que votre meilleur praticien dirait à un nouveau collègue. Les scripts sont facultatifs et beaucoup de compétences utiles n'en ont pas.

D'où viennent les compétences ?

Vous les écrivez pour votre propre travail, ou vous installez celles que d'autres ont publiées. Anthropic en publie un ensemble ouvert, et il existe des répertoires communautaires ; le nôtre recense les compétences publiques, avec attribution, et renvoie à la source au lieu de la copier.

Les compétences fonctionnent-elles avec n'importe quel assistant IA ?

Le format est apparu pour Claude et est pris en charge sur les surfaces d'Anthropic ; d'autres cadres d'agents ont adopté des conventions de chargement proches. La portabilité n'est pas garantie comme un protocole la garantit : une compétence est un document plus une convention pour le trouver, pas une norme implémentée des deux côtés.

Demandé à voix haute

dit, non tapé

Le même terme dans les mots employés en parlant à un assistant plutôt qu’en tapant dans un champ de recherche — écrit depuis la situation, et c’est pourquoi chaque question porte la situation dont elle vient.

Notre équipe recolle sans cesse les mêmes consignes à l'IA et la moitié passe à la trappe. Y a-t-il mieux ?

C'est exactement l'usage d'une compétence. Prenez les consignes vraies à chaque fois, mettez-les dans un fichier avec une description du moment où elles s'appliquent, et l'agent les charge quand le travail se présente au lieu de les traîner dans toute la conversation et de les perdre parmi le reste.

une échéancequelqu'un qui attend derrière
Quelle différence entre une compétence et un serveur MCP, en une phrase ?

Un serveur donne de la portée — ce que l'agent peut lire et faire ; une compétence donne le savoir-faire — comment bien mener un travail précis. La portée sans savoir-faire donne un travail assuré sur la mauvaise question ; le savoir-faire sans portée donne de bons conseils et aucune action.

en déplacementrien d'installé
On m'a envoyé une compétence à installer et je ne sais pas si elle est sûre.

Ouvrez-la et lisez-la : c'est un fichier texte, et le lire est l'audit. Vous confiez à son auteur tout ce que l'agent sait déjà faire, donc les questions sont : qui l'a écrite, demande-t-elle à l'agent d'exécuter des scripts, et quelque chose lui dit-il de sauter une confirmation.

un document précisce qu'ils ne trouvent pas

Plus dans GEO / recherche IA