snowflake-v2-progressive-disclosure-pattern-for-large-skill-files
Skill files exceeding 600 lines should be refactored into a lean entry-point (50–100 lines containing only a phase map table and workspace-detection logic) plus per-phase reference files loaded on-demand when that phase executes. This pattern reduced session-close SKILL.md from 1,230 to 54 lines — a 95.6% reduction in entry-point token cost — while preserving all phase content verbatim. Reference files are only loaded during their specific phase, not upfront, making the skill both cheaper and easier to maintain.