Progressive disclosure

Progressive disclosure is het laadmodel dat skills goedkoop maakt. In een normale sessie worden alleen de description en when_to_use tekst van de skill SKILL.md in de context geladen, zodat Claude weet wat er beschikbaar is; de volledige skillinhoud wordt pas geladen wanneer de skill wordt aangeroepen.

Er bestaat een derde niveau: skills kunnen meerdere bestanden in hun map bevatten, en die referentiebestanden worden pas geladen wanneer Claude ze daadwerkelijk leest. Er zijn dus drie niveaus: beschrijving altijd in context, SKILL.md body bij aanroep, en gebundelde bestanden op aanvraag.

De gecombineerde description en when_to_use tekst wordt afgekapt op 1.536 tekens in de skillvermelding om het contextgebruik te verminderen (configureerbaar via skillListingMaxDescChars). Zodra een skill is geladen, blijft de inhoud ervan in de context gedurende de beurten, dus elke regel van de body is een terugkerende tokenkosten. Houd de SKILL.md body beknopt en plaats lang referentiemateriaal in aparte bestanden.

Subagents met vooraf geladen skills werken anders: de volledige skillinhoud wordt bij het opstarten geïnjecteerd. Dit staat in contrast met het standaardmodel waarbij skills progressief worden geladen, waardoor de initiële context-window voetafdruk wordt geminimaliseerd.