instruction-file-splitting

What problem does it solve?

This Skill prevents instruction-heavy markdown files from exceeding model context thresholds where later rules get silently compressed or dropped, causing agents to miss important constraints.

Core Features & Use Cases

• Rule-preserving splitting: Breaks long instruction content into a short parent plus topic-owned sub-files so every rule is honored.
• Hard-rule placement: Ensures MUST/NEVER/ALWAYS “iron rules” stay in the parent at the very top, never duplicated in sub-files.
• On-demand detail routing: Creates a concrete “read when” pointer table so the agent loads the right depth only when a specific situation occurs.
• Trigger-based refactoring: Splits when files are 280+ lines, edits would push past 300, nesting gets too deep, or duplicated hard rules appear.
• Safety checklist: Verifies the parent stays under 150 lines and sub-files remain under 300 while avoiding vague pointers and duplicated rules.

Quick Start

Use the instruction-file-splitting skill to split your instruction markdown into a short router SKILL.md and topic-specific references when the file is near or above 300 lines.