Agent Skills

Définition

Une Agent Skill est un dossier que l’agent peut découvrir et charger quand la tâche le demande. Le contrat public, fixé par agentskills.io, tient dans un fichier SKILL.md : un frontmatter YAML (nom, description activable, licence) et un corps Markdown qui enseigne la procédure. Ce n’est pas un plugin magique ni un prompt collé dans le système : c’est de la documentation exécutable, versionnée, redistribuable si la licence le permet.

Shamalo sépare nettement les skills officielles (vendors Cursor, Anthropic, etc., licence en clair) des skills d’enseignement que nous écrivons pour montrer le format. Les secondes ne prétendent pas concurrencer le catalogue officiel.

Quand ça compte

Vous en avez besoin dès qu’un agent doit répéter un geste métier — analyser un SRM, rédiger une hypothèse CRO, valider un plan de marquage — sans que vous réexpliquiez la procédure à chaque session. La skill vit dans le dépôt, pas dans la mémoire de l’opérateur.

C’est aussi le bon niveau d’abstraction quand vous voulez auditer ce que l’agent a le droit de faire : la skill est lisible par un humain, diffable dans git, et refusée par le chargeur si le frontmatter est hors spec.

Pièges

Le piège classique est de traiter la skill comme un article de blog : un pavé que l’agent charge en entier à chaque tour. Vous brûlez le budget de contexte et vous noyez la description activable. L’autre piège est de copier une skill officielle dont la licence n’autorise pas la redistribution — la bibliothèque Shamalo refuse ce gris : carte + URL source, jamais un clone.

Termes liés

• SKILL.md
• Progressive disclosure
• Budget de contexte

Outil associé

Parcourir, filtrer et copier des Agent Skills, licence et source en clair : Ouvrir la bibliothèque de skills.