skill-400-line-hard-limit-enforced-via-references-subdir-extraction
Skills that exceed the 400-line hard limit should be refactored by extracting verbose sections into a references/ or docs/ subdirectory and linking them inline — not by trimming content. website-creator went 583→282 lines this way (3 new reference docs), frontend-redesign went 410→128 (3 docs subdir files). The skill body retains triggers, protocols, and decision logic; reference docs hold rubrics, pipelines, and integration details.
Related
- helix-skill-400-line-hard-limit-enforcement
- 400-line-hard-limit-enforced-via-lint-not-honor-system
- 2026-04-04-oracle-001-self-architecture-analysis
- skill-file-progressive-disclosure-for-over-600-line-splits
- progressive-disclosure-resolves-ambiguity-without-content-lo
- helix-skill-400-line-hard-limit-now-lint-enforced
- helix-skill-400-line-hard-limit-progressive-disclosure-disci
- progressive-disclosure-split-pattern-net-positive