Progressive disclosure

Progressive disclosure es el modelo de carga que hace que las skills sean baratas. En una sesión normal, solo se cargan en el contexto la description y el texto when_to_use de SKILL.md para que Claude sepa qué está disponible; el contenido completo de la skill se carga solo cuando se invoca la skill.

Existe un tercer nivel: las skills pueden incluir múltiples archivos en su directorio, y esos archivos de referencia se cargan solo cuando Claude realmente los lee. Por lo tanto, hay tres niveles: la descripción siempre en contexto, el cuerpo de SKILL.md al invocar, y los archivos empaquetados bajo demanda.

El texto combinado de description y when_to_use se trunca a 1,536 caracteres en la lista de skills para reducir el uso de contexto (configurable a través de skillListingMaxDescChars). Una vez que una skill se carga, su contenido permanece en contexto entre turnos, por lo que cada línea del cuerpo es un costo de token recurrente. Mantén el cuerpo de SKILL.md conciso y empuja el material de referencia largo a archivos separados.

Los subagentes con skills pre-cargadas funcionan de manera diferente: el contenido completo de la skill se inyecta al inicio. Esto contrasta con el modelo estándar donde las skills se cargan progresivamente, minimizando la huella inicial de la context-window.