SKILL.md
Documentation Review Skill
Executes the 7-phase review from REVIEW_PHASES.md using standards from AGENTS.md.
Arguments
- file-paths: One or more
.mdxfiles (required) - --phases / -p: Specific phases to run, e.g.
--phases 1-3or--phases 4,5,7(default: all) - --fix / -f: Implement fixes automatically (default: report only)
- --report-only / -r: Generate report without changes
Phase Overview
- User Success Evaluation - Both decision-maker and implementer personas can succeed
- Technical Accuracy - All technical content is correct and current
- Cross-Document Relationships - Docs form a cohesive workflow
- Document Structure Compliance - WAF-specific structure and formatting
- SEO & AI/LLM Optimization - See
/seo-optimizefor criteria - Link Quality & Balance - Right mix of beginner and advanced resources
- Final User Success Check - Both personas succeed with the document
Phase 8 (Code Example Validation) requires tool execution — request /code-review separately.
Read REVIEW_PHASES.md for detailed review questions and criteria per phase.