Skill Progressive Disclosure
Pattern d'architecture skill formalisé par Anthropic dans son article 'Equipping Agents with Agent Skills' : un skill expose progressivement plus de détails à l'agent selon le contexte. Niveau 1 : description courte (1 ligne) toujours en contexte. Niveau 2 : SKILL.md complet chargé si l'agent juge le skill pertinent. Niveau 3 : fichiers ressources (templates, scripts) chargés à la demande. Évite de saturer le contexte avec des détails inutiles tout en gardant la pleine capacité accessible.
Forces
- Économie de contexte massive : 50 skills installés ≈ 5KB en contexte au lieu de 500KB
- Pédagogiquement structuré : skill devient lisible comme un livre (overview → détails)
- Pattern officiel Anthropic, supporté nativement par Claude Code et Skills SDK
Limites
- Demande discipline d'écriture : structurer un skill en niveaux exige de penser hiérarchie info
- Niveau 1 (1 ligne) doit être très bien rédigé, c'est le seul moment où l'agent décide d'invoquer ou pas
Pour qui
- Design system manager qui ship des skills internes (ds-audit, component-create, token-update) à son équipe
- Équipe qui dépasse 5 skills installés et constate ralentissement / context overflow