context-split

Split large CLAUDE.md files into smaller child files with navigation.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/spencerbeggs/claude-design-coordinator --skill context-split
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-split
Source: https://github.com/spencerbeggs/claude-design-coordinator/tree/main/.claude/skills/context-split
Command: npx skills add https://github.com/spencerbeggs/claude-design-coordinator --skill context-split

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Splits large CLAUDE.md files into smaller, focused child files to reduce the size of the main context and improve navigation and load performance.

Core Features & Use Cases

  • Analyze CLAUDE.md structure to identify logical split points (sections, topics, or custom groupings).
  • Create focused child files (e.g., CLAUDE.commands.md, CLAUDE.architecture.md) while preserving content hierarchy and code blocks.
  • Update the parent CLAUDE.md with navigation and references to the new children to enable targeted loading.
  • Validate splits to ensure line limits are respected and cross-references remain valid.

Quick Start

Run the context-split skill on CLAUDE.md to generate child files and update the parent with navigation.

Frequently Asked Questions about context-split

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split a large CLAUDE.md file into smaller markdown files?

To split a large CLAUDE.md file, this skill analyzes the document structure, identifies logical split points, creates focused child files like CLAUDE.architecture.md, and updates the parent with navigation references to reduce master context length.

When should I split my CLAUDE.md documentation into child files?

You should split CLAUDE.md documentation when the master file becomes too large, causing slow load performance and bloated context, to enable targeted loading of specific topics while preserving content hierarchy and coherence.

How do I organize markdown documentation into a parent-child file structure?

Organizing markdown into a parent-child structure involves identifying sections or topics, creating per-topic child files, and updating the parent file with navigation references to ensure cross-references remain valid and coherent.

Can I preserve content hierarchy and code blocks when splitting markdown files?

Yes, splitting markdown files preserves content hierarchy and code blocks by analyzing the document structure and creating focused child files that maintain the original formatting and cross-references.

Does splitting CLAUDE.md files validate line limits and cross-references?

Splitting CLAUDE.md files validates line limits and cross-references through a structured workflow that ensures the resulting child files remain under specified limits and that all navigation links remain valid.

What is the best way to reduce context length in large markdown documentation?

The best way to reduce context length in large markdown documentation is to split the file into focused child files, creating per-topic navigation that allows targeted loading instead of parsing the entire master document.