| name | docs-review |
| description | Reviews documentation for voice, style, and structure alignment with Outfitter standards. Use when reviewing docs, checking content quality, or when "review this doc", "voice check", "style review", or "is this ready?" are mentioned. |
| context | fork |
| agent | editor |
| metadata | {"version":"1.0.0","author":"outfitter"} |
Documentation Review
Review the current document against Outfitter standards for voice, style, and structure.
Review Direction
$ARGUMENTS
If direction is provided above, focus on that specific aspect. Otherwise, perform a general review across all dimensions.
Review Criteria
Voice
Does it sound like Outfitter?
- Confident, opinionated stance
- Agents as first-class consumers
- Plain language over jargon
Style
Is the craft right?
- Punch-and-flow rhythm (short + long sentences)
- Earned enthusiasm (backed by substance)
- Strong opening and closing
Structure
Does it follow documentation patterns?
- Appropriate template usage
- Complete, runnable examples
- Correct heading hierarchy (h1 > h2 > h3)
Output Format
Provide your review in this format:
Status: Ready | Needs Work
Summary: One sentence overall assessment.
Issues (if any):
- [Location] Issue description and suggested fix
Strengths:
If the document is ready, say so briefly. If it needs work, be specific about locations and fixes.
