doc-migrator

What problem does it solve?

Consolidating scattered documentation into a structured format is a daunting task, often leading to lost information or broken links. This Skill automates the process of finding, classifying, merging, and safely archiving existing documentation into a standardized .claude/ structure.

Core Features & Use Cases

• Automated Document Discovery: Scans the entire repository for Markdown files, excluding specific directories.
• Content Classification: Automatically categorizes documents (e.g., requirements, architecture, patterns) based on keywords.
• Safe Archiving: Moves original documents to a timestamped archive directory and updates .gitignore, preserving history.
• Use Case: During a project bootstrap or major refactoring, run this Skill to automatically migrate all existing .md files into the new .claude/docs/ structure, ensuring no valuable information is lost and the project starts with organized documentation.

Quick Start

Run the script to migrate and archive documents

python .claude/skills/doc-migrator/migrate_docs.py