visual-review

Analyze user-visible surfaces and diffs across web, mobile, CLI, and reports.

3|1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/malinskibeniamin/skills --skill visual-review-malinskibeniamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: visual-review
Source: https://github.com/malinskibeniamin/skills/tree/main/visual-review
Command: npx skills add https://github.com/malinskibeniamin/skills --skill visual-review-malinskibeniamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews customer-facing surfaces with product, design, engineering, and QA hats from visual or interaction evidence before PRs/releases. It helps identify user-visible issues early, turning subjective taste into evidence-driven guidance.

Core Features & Use Cases

  • Evidence-driven evaluation: reviews surfaces using artifacts from UI/UX, engineering, and QA to ground findings in observable data.
  • Design-language guidance: applies a taxonomy of handles (hierarchy, density, rhythm, anchor, negative space, measure, visual weight) to guide actionable adjustments.
  • Cross-context coverage: usable for web, mobile, CLI/TUI, and generated reports to ensure consistency across touchpoints.

Quick Start

Inspect a changed surface with the visual-review workflow and load REFERENCE.md for guidance.

Frequently Asked Questions about visual-review

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

FAQPage Schema
How do I review UI changes for visual and accessibility issues before a release?▼

Visual review evaluates customer-facing surfaces by analyzing interaction evidence from UI, engineering, and QA artifacts. It grounds subjective design decisions in observable data to identify user-visible issues early across web, mobile, and CLI touchpoints.

Do I need Playwright and route fixtures to perform a visual surface diff?▼

Yes, performing a visual surface diff requires project tooling like Playwright and route fixtures. You also need a defined surface register and a taxonomy of design-language handles to guide the evaluation and produce actionable adjustments.

Can I apply design-language guidance to CLI and TUI surfaces?▼

Yes, you can apply design-language guidance to CLI and TUI surfaces. The visual review process evaluates consistency across web, mobile, CLI, and generated reports to ensure cross-context coverage and identify interaction flow gaps.

What is the best way to turn subjective UI design feedback into evidence-driven guidance?▼

The best way to turn subjective UI feedback into evidence-driven guidance is applying a taxonomy of handles like hierarchy, density, rhythm, and negative space. This grounds visual review findings in observable artifacts for actionable tweaks.

What limitations exist when reviewing user-visible surfaces without a defined surface register?▼

Without a defined surface register, visual review cannot systematically analyze user-visible surfaces or produce evidence-backed findings. The process depends on this register alongside project tooling to accurately surface design and engineering gaps before releases.