Glossaire Claude Code
Progressive disclosure
La divulgation progressive charge le contenu des compétences à la demande, réduisant le coût initial du contexte.
Aussi appelé : progressive disclosure skills, lazy loading skills
La divulgation progressive est le modèle de chargement qui rend les compétences peu coûteuses. Dans une session normale, seules la description et le texte when_to_use du SKILL.md sont chargés dans le contexte afin que Claude sache ce qui est disponible ; le contenu complet de la compétence ne se charge que lorsque la compétence est invoquée.
Il existe un troisième niveau : les compétences peuvent inclure plusieurs fichiers dans leur répertoire, et ces fichiers de référence ne se chargent que lorsque Claude les lit réellement. Il y a donc trois niveaux : la description toujours dans le contexte, le corps du SKILL.md lors de l'invocation, et les fichiers groupés à la demande.
Le texte combiné description et when_to_use est tronqué à 1 536 caractères dans la liste des compétences pour réduire l'utilisation du contexte (configurable via skillListingMaxDescChars). Une fois qu'une compétence est chargée, son contenu reste dans le contexte entre les tours, donc chaque ligne du corps représente un coût récurrent en tokens. Gardez le corps du SKILL.md concis et poussez le matériel de référence long dans des fichiers séparés.
Les sous-agents avec des compétences préchargées fonctionnent différemment : le contenu complet de la compétence est injecté au démarrage. Cela contraste avec le modèle standard où les compétences sont chargées progressivement, minimisant l'empreinte initiale de la context-window.