reviewing-user-flows

Review finished user-flows documents against a 14-condition bar and emit an approve or revise verdict.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill reviewing-user-flows-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-user-flows
Source: https://github.com/bm629/agent-skills/tree/main/skills/reviewing-user-flows
Command: npx skills add https://github.com/bm629/agent-skills --skill reviewing-user-flows-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Before wireframing begins, someone must decide whether a user-flows document is complete, walkable, resilient, and accessible enough to build screens from. Reviewing it informally leads to rubber-stamped approvals or subjective nitpicks, and a reviewer who also fixes the doc collapses the author/reviewer separation. ## Core Features & Use Cases - Fixed 14-condition checklist: Judges goal coverage, entry/exit definition, branch resolution, error recovery, notation sync, screens enumeration, navigation/IA, interaction resilience, flow-level accessibility, objective flow quality, and delta-scoped amendment review. - Machine-parseable verdict: Emits exactly VERDICT: approve or VERDICT: revise on its own line, followed by actionable findings naming the failed condition, location, and concrete fix. - Proportionality rules: Conditions collapse on thin products (single-screen tools, read-only flows, greenfield builds) so small docs are never false-revised, while dead ends and unguarded irreversible actions always block. - Use Case: After an agent authors a user-flows document for a checkout redesign, run this skill as the independent gate; it returns a revise verdict with findings like a missing loading state on the payment step, which the author fixes in one bounded pass. ## Quick Start Use reviewing-user-flows to judge the attached user-flows document and tell me whether it is ready for wireframing.

Frequently Asked Questions about reviewing-user-flows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a user-flows document before wireframing?

Run this skill on the finished user-flows document; it judges the doc against 14 conditions covering completeness, walkability, resilience, and accessibility, then emits VERDICT: approve or VERDICT: revise with actionable findings for each gap.

What makes a user-flows document ready for wireframing?

Every PRD goal maps to a flow, entries and exits are defined, branches resolve, error and loading states have recoveries, screens are enumerable in a canonical index, irreversible actions are guarded, and every path is keyboard and AT completable.

Does this skill check visual accessibility like contrast and target size?

No. Per-screen pixel WCAG concerns such as contrast, target size, and focus appearance belong to a wireframes-review skill. This gate only checks flow-level accessibility: keyboard completability, AT-announced errors, and focus management across steps.

Can this skill fix or rewrite the user flows it reviews?

No. It is strictly a judging gate that returns findings naming the failed condition, exact location, and concrete fix. Authoring or repairing flows is handled by the paired authoring-user-flows skill.

How does the review handle amendments to an existing user-flows doc?

Condition 13 scopes the review to the diff and its ripple: it checks that untouched flows are unchanged, hand-offs still resolve, the screens index stays consistent, and the version bump matches the change class per SemVer-style rules.

Why did a small user-flows doc get approved despite missing sections?

Conditions 9 through 13 collapse on thin archetypes: a single-screen tool has no app shell, a read-only flow has nothing to guard, and greenfield builds skip delta review. Only four non-collapsing baseline conditions apply at every size.