Documentation
Le format, les portes et les surfaces.
Le format de skill
Une skill est un répertoire contenant SKILL.md — un fichier Markdown avec un frontmatter YAML portant un `name` et une `description`. La description est ce que lit un agent pour décider de charger la skill : elle doit donc dire à la fois ce que fait la skill et quand l'utiliser. Les fichiers de support vivent à côté et sont référencés depuis le corps, si bien que l'agent ne les lit qu'en cas de besoin.
Portes qualité
La porte 0 valide le frontmatter et le schéma. La porte 1 analyse la structure — divulgation progressive, limites de taille, pas de chemins absolus, pas de secrets divulgués. Les deux s'exécutent dans la requête, en moins d'un cinquième de seconde. La porte 2 lance une évaluation de déclenchement en asynchrone : un modèle juge vérifie si la skill se déclenche sur les prompts attendus et reste silencieuse sur les autres. La porte 3 exécute les scripts fournis dans un bac à sable.
Installer une skill
Chaque page de skill affiche une commande d'installation d'une ligne. Elle écrit le répertoire de la skill dans votre projet afin que votre agent le prenne en compte au prochain lancement. Rien n'est installé globalement et rien ne s'exécute à l'installation.
Surfaces lisibles par les agents
Le registre se publie dans les formats que cherchent les agents : /llms.txt comme index Markdown, /index.json comme index typé, et un rendu Markdown propre de chaque skill. Un en-tête Content-Signal déclare comment le contenu peut être utilisé. C'est la même mécanique dont traitent les skills elles-mêmes.
Example SKILL.md
---
name: core-web-vitals-audit
description: Audits a web application for Core Web Vitals
regressions. Use when the user asks to check LCP, INP or
CLS, or investigate a Lighthouse score drop.
---
# Core Web Vitals audit
## When to use this
...
## Procedure
1. Measure first, guess never.
2. See [references/thresholds.md](references/thresholds.md).