reviewing-user-guide — SKILL.md

Variant: standard · When to use: judging a finished end-user guide as an acceptance gate — checking a real user can accomplish every supported goal from it, then emitting VERDICT: approve|revise with actionable findings.

Overview

This skill is the review half of a producing/judging end-user-guide pair. Loaded by a reviewer who holds a finished end-user guide — the consumer-facing help the person using a product (typically non-technical) reads to accomplish their goals (a getting-started tutorial, task-oriented how-to guides, conceptual explanation, an end-user feature/configuration reference, and troubleshooting/FAQ) — it judges that guide against one question: can a real user of the product accomplish every supported goal from this guide alone, without asking the author, with steps that match how the product actually behaves? It applies a fixed usability + accuracy checklist — the same bar a user-guide author produces to, so the produce-bar and the review-bar do not drift — then emits a single machine-parseable verdict plus findings the author can act on in one revision pass. It judges the textual markdown artifact (prose, fenced snippets, screens described in words with wireframe links), not a rendered help site; the method and bar are medium-independent. It is an acceptance gate — it does not author, fix, or rewrite the guide; it judges and returns findings, and the producer revises.

When to activate

• A finished end-user guide needs an accept/revise decision before it ships to its users.
• You are the independent reviewer / gate for an end-user guide a producer just authored.
• Re-judging a revised end-user guide after a prior revise verdict.

Do NOT activate when: