doc-reorganize

To reorganize Markdown documentation, this Skill uses file frontmatter to sort files into category subdirectories. It validates the file structure, updates cross-references, and generates a README index using `git mv` for file movements.

When moving Markdown files to new folders, this Skill automatically updates cross-references using `grep`. It ensures that links remain valid and navigable after the documentation is reorganized into category subdirectories.

No, this Skill reorganizes documentation files based on their frontmatter. Markdown files must contain valid frontmatter categories to be successfully sorted into category subdirectories and have a README index generated.

Yes, this documentation reorganization tool generates a README index. This index serves as a navigational table of contents, reflecting the newly validated category subdirectory structure and updated cross-references.

The best way to restructure scattered Markdown files is using automated frontmatter categorization. This Skill validates the existing structure, commits changes with descriptive messages, and uses `git mv` to maintain version history during reorganization.

Using `git mv` when reorganizing documentation preserves file history during version control. This ensures that moving Markdown files into category subdirectories and updating cross-references does not break your repository's commit tracking.