SYS/DEF
Progressive disclosure
Ne montrer à l’agent que ce dont il a besoin maintenant : d’abord la description, ensuite le corps, ensuite les fichiers. Épargner le contexte.
Définition
La progressive disclosure, dans la spec Agent Skills, est la règle de chargement : l’agent lit d’abord les métadonnées (nom, description) pour décider si la skill s’applique ; il n’injecte le corps Markdown que sur match ; les fichiers annexes ne viennent que s’ils sont référencés. C’est le contraire du system prompt encyclopédique.
En UX produit, le même mot désigne l’interface qui révèle la complexité à la demande. Ici, le « utilisateur » est le modèle, et le coût est en tokens.
Quand ça compte
À l’écriture de chaque SKILL.md : la description doit être déclenchable seule (« use when you need to check an SRM split »), le corps en étapes, les exemples lourds dans des fichiers à part. C’est aussi le critère de revue d’une skill « officielle » : si tout est dans le body, ce n’est plus une skill, c’est un manuel collé.
Le quiz Agent Skills de Shamalo teste précisément ça, pas la récitation du YAML.
Pièges
Tout mettre dans la description « pour être sûr que ça match ». Répéter le frontmatter dans le corps. Pointer dix fichiers « au cas où ». Croire que le chargeur lira les sous-dossiers sans lien explicite.
Termes liés
Outil associé
Frontmatter, description activable, divulgation progressive, budget — score sur 100 : Ouvrir quiz Agent Skills.