Qu'est-ce qu'une Agent Skill ?

Une Agent Skill est un dossier qui contient un fichier SKILL.md. Ce fichier dit à votre agent de code comment réaliser une tâche précise, et l'agent ne le lit que lorsque la tâche s'y prête.

Ce que contient une skill

Le cœur d'une skill est le fichier SKILL.md. Il commence par un en-tête YAML (le frontmatter) suivi d'instructions en Markdown :

---
name: audit-accessibilite
description: Vérifie l'accessibilité d'une page web et propose des corrections. À utiliser quand on demande un audit d'accessibilité, RGAA ou WCAG.
---

# Audit d'accessibilité

1. Ouvrez la page et listez les composants interactifs.
2. Vérifiez les contrastes, les libellés et la navigation au clavier.
3. Rendez un tableau des problèmes, classés par gravité.

Selon la spécification, deux champs sont obligatoires :

• name : 64 caractères au maximum, en minuscules, chiffres et tirets, identique au nom du dossier ;
• description : 1 024 caractères au maximum. Elle dit ce que fait la skill et quand l'utiliser. C'est elle que l'agent lit pour décider s'il doit charger la skill.

D'autres champs sont facultatifs, par exemple license, compatibility ou metadata. Le corps du fichier n'a pas de format imposé : étapes, exemples, cas limites.

Le dossier peut aussi contenir des fichiers annexes. La spécification propose trois sous-dossiers par convention :

Pourquoi l'agent la charge « à la demande »

Une skill n'est pas collée dans chaque conversation. Les agents la chargent en trois temps, ce que la spécification appelle la divulgation progressive :

1. Découverte : au démarrage, l'agent ne lit que le nom et la description de chaque skill installée.
2. Activation : si votre demande correspond à une description, il lit le SKILL.md en entier.
3. Exécution : il suit les instructions et ouvre les fichiers annexes seulement quand l'étape les demande.

Vous pouvez donc installer beaucoup de skills sans alourdir chaque échange. En contrepartie, tout repose sur la description : si elle est vague, l'agent ne reconnaîtra pas le moment de s'en servir. La spécification recommande aussi de garder le SKILL.md sous 500 lignes et de déplacer le détail dans des fichiers séparés.

D'où vient le format

Anthropic a publié le format comme standard ouvert en décembre 2025, avec une spécification sur agentskills.io. L'entreprise a ensuite annoncé qu'elle confiait le standard à l'Agentic AI Foundation pour le garder ouvert et neutre vis-à-vis des éditeurs, et que plus de 70 plateformes d'agents l'avaient intégré.

Concrètement, une skill écrite pour un agent peut servir à un autre. Claude Code suit le standard et y ajoute ses propres options, par exemple le contrôle de l'invocation. Une skill qui se limite aux champs standard reste donc portable.

Quels agents la lisent

Les trois agents suivants documentent le format et leurs dossiers :

Retrouvez ces agents sur leurs pages : Claude Code, Codex, Cursor. Beaucoup d'autres agents lisent aussi le format : le catalogue en liste une trentaine, chacun avec son dossier d'installation.

Ce que PalateKit ajoute

Les skills ne couvrent pas tout ce qu'un agent de code utilise. PalateKit réunit dans un seul catalogue, en français et en anglais :

• des Agent Skills, au format décrit ci-dessus ;
• des fichiers DESIGN.md, qui décrivent le système visuel d'un projet pour que l'agent produise une interface cohérente ;
• des templates de motion design ;
• des prompts pour le texte, l'image et la vidéo ;
• des rules, agents et hooks.

Ces autres types de ressources ne sont pas des skills au sens de la spécification : ce sont des fichiers que l'agent lit ou que vous collez, avec leurs propres emplacements. Chaque fiche indique où les placer.

Installer une ressource revient à copier des fichiers. Rien ne s'exécute pendant l'installation, et le catalogue ne propose pas de ressource qui livre des scripts. Les trois méthodes (prompt d'installation, commande, ZIP) sont décrites dans Installer votre première ressource, et la différence avec un simple prompt dans Ressource ou prompt ?.