doc-splitter

Split large documentation sites into focused sub-skills with routing.

175|26|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/jmagly/ai-writing-guide --skill doc-splitter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-splitter
Source: https://github.com/jmagly/ai-writing-guide/tree/main/agentic/code/addons/doc-intelligence/skills/doc-splitter
Command: npx skills add https://github.com/jmagly/ai-writing-guide --skill doc-splitter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Splits large documentation sites into smaller, navigable sub-skills for better maintenance.

Core Features & Use Cases

  • Category-based or size-based splitting
  • Router integration for navigation
  • Validation checks and recovery

Quick Start

Configure a large doc site and run the split with a router strategy.

Frequently Asked Questions about doc-splitter

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

FAQPage Schema
How do I split large documentation sites into smaller, manageable sub-skills?

Split large documentation by configuring your doc site source and choosing a splitting strategy—category-based, size-based, router-based, or hybrid. The Skill analyzes page counts, estimates targets, generates focused sub-skills, and creates optional router skills for intelligent navigation across your documentation corpus.

Can I use doc splitting for massive documentation like AWS or Godot?

Yes. Doc-splitter handles documentation corpora with 10,000+ pages. It performs category analysis, page-count estimation, target-skill sizing, and automated sub-skill generation with standardized SKILL.md outputs, designed specifically for enterprise-scale documentation.

What splitting strategies are available for organizing documentation?

Four strategies apply: category-based splitting groups docs by topic, size-based splitting divides by page count, router-based splitting uses intelligent navigation, and hybrid splitting combines multiple approaches. Choose based on your documentation structure and maintenance goals.

Does doc splitting include recovery and progress tracking for large operations?

Yes. The Skill includes recovery protocols and progress tracking to handle interruptions during splitting of massive documentation sets, plus validation checks and checkpoint standardization to ensure consistent, resumable operations.

What input format and dependencies do I need to use doc-splitter?

Configure your documentation site as input. The Skill depends on PyYAML for configuration parsing. It accepts standard documentation structures and outputs focused sub-skills with router integration and standardized metadata formats.