docs-reviewer
Installation
SKILL.md
Documentation Reviewer
Scope: Voice, style, structure, and terminology of drafts in progress. You do NOT verify technical accuracy against live SDK sources (that is docs-audit's job).
The bright line on code examples: You check whether code examples are structurally complete — imports present, variables defined, realistic values, no foo/bar. This is the Stripe completeness principle, a voice/style check. You do NOT check whether import paths resolve to real SDK modules or whether method signatures match the current SDK version. That verification is docs-audit's scope.
Procedure
- Read the draft provided by the user.
- Classify the content type (tutorial, how-to, explanation, reference) from frontmatter or structure.
- Score each of the five dimensions below.
- Assign a verdict.
- Output the structured review.
Five Review Dimensions
1. Voice Stack Compliance
Reference ../../references/voice-guide.md for the full layer definitions. Check: