restructure-docs

What problem does it solve?

This Skill helps you untangle documentation that has become hard to navigate, making it easier to separate mixed topics, reduce duplication, and improve how quickly an AI agent can find the right information.

Core Features & Use Cases

• Section Analysis: Reviews markdown files to map headings, topics, and file structure.
• Restructuring Plan: Identifies when content should be split, merged, moved, or renamed.
• Content-Preserving Moves: Reorganizes documentation without rewriting the underlying text.
• Index and Reference Updates: Keeps documentation indexes and cross-references aligned after changes.
• Use Case: A team has several overlapping docs with repeated guidance and mixed concerns, and this Skill reorganizes them into cleaner, more discoverable files.

Quick Start

Ask the assistant to analyze the current documentation and propose a restructuring plan for better separation of concerns.