markdown-repo-curator

What problem does it solve?

This Skill helps maintain clean, searchable documentation by identifying duplicate or rarely-referenced markdown files and providing a safe, manifest-driven way to move or delete them without losing important product memory.

Core Features & Use Cases

• Inventory and hygiene scan that lists all markdown files and generates actionable recommendations.
• Duplicate basename detection and identification of low-reference candidates for archival or deletion.
• Manifest-driven apply workflow that requires explicit DELETE and MOVE operations, with guardrails to protect critical files such as README.md, CLAUDE.md, and AGENTS.md.
• Use Case: Prepare a repository for public release by archiving historical docs into docs/archive/ and removing stale, unreferenced markdown.

Quick Start

Run a markdown hygiene audit, review duplicates and low-reference candidates, assemble a reviewed manifest of MOVE and DELETE operations, and then apply the manifest to archive or remove files.