docs-organize

What problem does it solve?

Project documentation is often inconsistent, incomplete, or outdated, leading to poor team collaboration, slow onboarding, and unclear project context. This Skill eliminates that manual overhead by automatically generating a complete, standardized documentation structure and objective project health score for any codebase.

Core Features & Use Cases

• Codebase Analysis: Automatically infers tech stack, project type, existing architectural decisions, and current project stage from existing code and configuration files.
• Contextual Gap Interview: Asks targeted user questions to fill missing context that cannot be inferred from code alone, ensuring generated docs are accurate and complete.
• Standardized Doc Generation: Produces a full docs/ structure including prd.md, architecture.md, UI_GUIDE.md (for frontend projects), STATUS.md with a 0-100 health score, and ADRs for key architectural decisions.
• Use Case: A small startup team with a scattered codebase and no formal documentation can run this Skill to get a complete, standardized docs package and a clear score to track project health over time.

Quick Start

Invoke the docs-organize skill by typing /docs-organize in any project directory to generate your standardized project documentation and health score.