doc-validator

What problem does it solve?

This Skill prevents documentation sprawl by identifying and flagging Markdown files located outside of predefined, standard directories, ensuring a clean and organized repository structure.

Core Features & Use Cases

• Markdown File Scanning: Scans the entire repository for .md files.
• Location Validation: Checks if found .md files reside in allowed directories (e.g., docs/, skills/*/, root).
• Warning Output: Reports any .md files found in non-standard locations.
• Use Case: Before merging a new feature branch, run this skill to ensure all new documentation files are placed in the correct docs/ or skills/ subdirectories, preventing clutter.

Quick Start

Run the doc validator script to check for misplaced markdown files.