progressive-disclosure-resolves-structural-ambiguity-in-skill-files
When a SKILL.md has duplicate section numbering (e.g., sections 9 and 10 appearing twice), the correct resolution is progressive disclosure: extract content blocks to docs/ subdirectory files and replace with pointer blocks in the main file. This eliminates the ambiguity, brings the main file under the 400-line target, and preserves every unique content line. The pattern yielded 761→406 lines for frontend-intelligence with 792 total lines across main + 6 docs files.
Related
- skill-progressive-disclosure-pattern-for-oversized-files
- skill-file-progressive-disclosure-for-over-600-line-splits
- progressive-disclosure-resolves-ambiguity-without-content-lo
- progressive-disclosure-as-ambiguity-resolution-pattern
- skills-over-600-lines-split-via-progressive-disclosure
- helix-dead-progressive-disclosure-references-at-scale
- progressive-disclosure-split-grows-total-skill-footprint
- progressive-disclosure-splits-break-skill-lint
- skill-shrinkage-does-not-imply-content-loss-check-total