restructure-docs

To restructure markdown documentation and reduce duplication, the Skill analyzes existing files to map headings and topics, then proposes a plan to split, merge, move, or rename content for clearer separation of concerns.

The best way to reorganize docs for AI retrieval is to apply content-preserving moves that improve discoverability, ensuring information is separated by concern without rewriting the underlying text.

Yes, you can split and merge markdown files without rewriting text. The Skill performs content-preserving moves, reorganizing documentation structure while keeping the original content intact.

To fix broken cross-references after moving documentation files, the Skill automatically updates documentation indexes and cross-references to align with the new file structure, verifying complete file coverage.

You need to restructure documentation for separation of concerns when your repository has multiple markdown files with overlapping guidance and mixed topics, making the information architecture hard to navigate.

Yes, the documentation restructuring approach requires a plan approval step. It identifies when content should be split, merged, moved, or renamed, and requires your approval before executing the reorganization plan.