visual-review

Review running UIs through screenshots and rendered-state measurements to report bugs and design feedback.

1|Updated Dec 18, 2009
One-click install
npx skills add https://github.com/thurn/dotfiles --skill visual-review-thurn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: visual-review
Source: https://github.com/thurn/dotfiles/tree/main/.llms/skills/visual-review
Command: npx skills add https://github.com/thurn/dotfiles --skill visual-review-thurn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Visual defects and weak interface design often slip past code review because they only appear in the rendered product. This Skill inspects a running UI directly, catching layout bugs, clipping, misalignment, and inconsistent component styling while also delivering substantive design critique aimed at a beautiful, minimal interface. ## Core Features & Use Cases - Rendered-State Inspection: Navigate real user flows with browser automation, capture screenshots across natural, wide, and narrow viewports, and measure bounding boxes, computed styles, and component clearances. - Mandatory Acceptance Gate: Verify layout geometry, component interiors, border-stack consistency across control families, and reference landmarks before declaring a review complete. - Design System Inference & Critique: Derive the product's tokens and component patterns, then produce severity-ordered Bugs and prioritized Design Feedback with concrete fix directions. - Use Case: Before a release, point the Skill at your staging URL to get a structured report covering responsive breakpoints, hover/pressed/focus states, and high-leverage simplification opportunities. ## Quick Start Use $visual-review to inspect this running UI and report visual bugs and high-impact design improvements for a beautiful, minimal interface.

Frequently Asked Questions about visual-review

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

FAQPage Schema
How do I review a running UI for visual bugs?▼

Point the Skill at your URL or launch path and it navigates the principal user flows with browser automation, capturing screenshots and measuring rendered geometry. It reports severity-ordered bugs with exact screen, viewport, state, and evidence for each finding.

What does a visual QA review check in a web interface?▼

It checks layout geometry, overflow, clipping, component interior alignment, hover and pressed states, responsive behavior across viewports, typography, contrast, and border consistency across control families. It also infers the design system and flags departures from it.

Does visual review work with Playwright browser automation?▼

Yes, it uses the project's designated browser automation and prefers the globally configured Playwright MCP service when none is specified. It does not launch a separate browser process or automation stack.

Can visual review replace an accessibility audit?▼

No, it explicitly excludes screen-reader semantics, ARIA structure, and keyboard navigation behavior unrelated to visible focus. Those concerns require a separate accessibility audit; this Skill covers only visual-scope issues like contrast and target size.

When should I not use visual UI review?▼

Avoid it for code-only review, semantic accessibility audits, or when the UI cannot be reached in a browser. It also does not implement fixes unless separately requested, and it will not substitute a code review when the running UI is unreachable.