reviewing-wireframes

Reviews textual wireframe documents against a buildability, coverage, and composition checklist and emits 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-wireframes-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-wireframes
Source: https://github.com/bm629/agent-skills/tree/main/skills/reviewing-wireframes
Command: npx skills add https://github.com/bm629/agent-skills --skill reviewing-wireframes-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Before hi-fi design and UI engineering begin, someone must decide whether a finished wireframes document is actually buildable — every flow-named screen and state covered, layouts unambiguous, components real, and accessibility reserved. This Skill acts as that independent acceptance gate, judging a markdown wireframe against a fixed, single-sourced bar instead of subjective taste. ## Core Features & Use Cases - Fixed 15-condition checklist: Judges screen coverage, per-screen states (empty/loading/error/success), layout clarity, component consistency, affordance annotation, microcopy, responsive behavior, screen-composition accessibility, and fidelity scope. - Machine-parseable verdict: Emits exactly one line — VERDICT: approve or VERDICT: revise — plus actionable findings naming the failed condition, location, and concrete fix. - Delta-scoped amend reviews: Reviews only the diff and its ripple effects when judging an amended document, rather than re-litigating untouched screens. - Use Case: After authoring wireframes for a checkout flow, run this reviewer with the wireframes doc plus the upstream user-flows and design-system; it returns a revise verdict with findings like a missing error state on the payment screen, which the author fixes in one pass. ## Quick Start Use reviewing-wireframes to judge the finished wireframes document at docs/specs/checkout-wireframes.md against the user-flows and design-system, and give me the verdict and findings.

Frequently Asked Questions about reviewing-wireframes

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

FAQPage Schema
How do I review a wireframes document before UI development?

Run this reviewer on the finished markdown wireframes doc, optionally providing the upstream user-flows and design-system for cross-checks. It judges the doc against a fixed buildability and coverage checklist and returns a VERDICT: approve or revise line with actionable findings.

What makes a wireframe fail a buildability review?

A wireframe fails when a flow-named screen or state has no wireframe, an applicable state like empty or error is missing, a component is invented outside the design-system, a layout is ambiguous, or the doc overshoots into hi-fi pixel decisions. Subjective layout taste is never a gap.

Does this review check accessibility in wireframes?

Yes, but only screen-composition accessibility: landmarks, heading order, focus order, accessible names, keyboard operability, and target-size reservation. Pixel contrast and focus-appearance belong to the design-system's contract and are explicitly out of scope.

Can it review an amended wireframes document?

Yes. For amendments it performs a delta-scoped review of only the diff and its ripple effects, checking that shared-region changes reached all reusing screens, version bumps match the change class, and the changelog matches the diff.

When should I not use this wireframe reviewer?

Do not use it for authoring wireframes, judging the navigation graph between screens, evaluating the design-system's token catalog or per-component accessibility contract, or reviewing high-fidelity visual design. Those belong to sibling skills for user-flows, design-system, and hi-fi review.