Review a document for completeness and quality. Use when user wants a document reviewed before approval or to check quality.
<skill_info> <name>nmblr:review</name>
<summary>Review a document for completeness, clarity, and quality.</summary> <agent>document-reviewer</agent> <config_file>.claude/nmblr/config.yaml</config_file> </skill_info> <usage> <syntax>nmblr:review <doc-id></syntax> <syntax>nmblr:review <doc-id> --detailed</syntax> <syntax>nmblr:review <doc-id> --checklist-only</syntax> <syntax>nmblr:review --all</syntax> <syntax>nmblr:review --type PD</syntax> <syntax>nmblr:review --type PD --status Draft</syntax> </usage> <arguments> <argument name="doc-id" required="false"> <description>Document ID to review (e.g., RFC-0023, PRD-0001). Required unless --all or --type is used.</description> </argument> </arguments> <options> <option name="--detailed">Provide detailed feedback with specific recommendations</option> <option name="--checklist-only">Only show checklist without scoring</option> <option name="--for-approval">Focus review on approval readiness</option> <option name="--all">Review all documents with status Draft or In-Review</option> <option name="--type" value_type="TYPE">Review all documents of a specific type (PD, RFC, PRD, ADR, TD, PPD, TP, TC)</option> <option name="--status" value_type="STATUS">Filter by status when used with --all or --type (default: Draft)</option> </options><execution_instructions> When this skill is invoked:
Read project configuration
.claude/nmblr/config.yamlResolve documents to review
list-documents.sh to find matching documents:
# All Draft documents of a specific type
bash .claude/nmblr/scripts/docs/list-documents.sh --type {TYPE} --status {STATUS:-Draft}
# For --all, iterate over types: PD, RFC, PRD, ADR, TD, PPD, TP, TC
Delegate to document-reviewer agent
document-reviewer agent with doc ID and optionsdocument-reviewer agent with all document paths and request batch review modeThe document-reviewer will:
| Doc ID | Type | Score | Recommendation |<review_criteria> <criteria_for type="RFC"> <item>Background and problem statement</item> <item>Proposed solution completeness</item> <item>Implementation feasibility</item> <item>Testing strategy</item> <item>Security and performance</item> <item>Rollback plan</item> </criteria_for>
<criteria_for type="PRD"> <item>Business value clarity</item> <item>User story completeness</item> <item>Acceptance criteria</item> <item>Technical feasibility</item> <item>Dependency identification</item> </criteria_for>
<criteria_for type="ADR"> <item>Context and drivers</item> <item>Options evaluation</item> <item>Decision rationale</item> <item>Consequence documentation</item> </criteria_for> </review_criteria>