Review Docs

Comprehensive documentation review, optimized for Docus/Nuxt Content but compatible with any Markdown documentation.

Workflow Overview

This skill performs a 5-step review process:

1. Detect Project Type - Identify Docus/Nuxt Content vs generic Markdown
2. Analyze Structure - Map documentation organization, locales, sections
3. Technical Validation - Check frontmatter, MDC syntax (if applicable), file naming
4. Content Quality Review - Evaluate clarity, SEO, structure, i18n
5. Generate Report - Provide categorized, actionable recommendations

Priority Levels

• Critical - Blocks deployment or causes errors (missing frontmatter, invalid MDC syntax)
• Important - Significantly impacts UX/SEO (poor metadata, passive voice, unclear headings)
• Nice-to-have - Polish and optimization suggestions (add callouts, improve examples)