visual-review

Screenshots website pages in light and dark mode at desktop and mobile widths to detect visual defects.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/robritacca-dotcom/design-system --skill visual-review-robritacca-dotcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-review
Source: https://github.com/robritacca-dotcom/design-system/tree/main/.claude/skills/visual-review
Command: npx skills add https://github.com/robritacca-dotcom/design-system --skill visual-review-robritacca-dotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Visual regressions like invisible text, clipped components, broken layouts, and stuck hover states often slip through code review because they only appear when a page is actually rendered in a browser across themes and viewport sizes. ## Core Features & Use Cases - Multi-theme, multi-viewport capture: Drives each page through light and dark mode at desktop and mobile (~375px) widths, toggling the data-theme attribute or the MegaNav theme switcher. - Targeted defect detection: Checks screenshots for invisible text, overflow, clipping, misalignment, stuck hover states, broken images, and unexpected differences between themes. - False-positive filtering: Distinguishes real bugs from expected behavior such as entry animations, the ambient background's dual renderers, chromeless routes, and desktopOnly navigation flags. - Use Case: After restyling a component, ask for a visual check and receive a per-page report formatted as [URL] [dark|light] [desktop|mobile] — description of issue, or confirmation that everything looks correct. ## Quick Start Ask the assistant to visually review the pages you just changed in both light and dark mode at desktop and mobile widths.

Frequently Asked Questions about visual-review

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

FAQPage Schema
How do I check a website in both light and dark mode?

Open the page in a browser preview and switch the rendered theme via the nav theme toggle or by setting the data-theme attribute on the html element. Screenshot each page in both themes and compare for invisible text, broken layouts, and unexpected differences.

How do I screenshot responsive pages at mobile width?

Resize the browser viewport to about 375px wide and capture each page again in both themes. At mobile width, also check for horizontal overflow, clipped content, and that the drawer navigation opens, scrolls, and closes correctly.

What visual issues should I look for when reviewing a webpage?

Look for text matching its background color, components overflowing or clipping, inconsistent spacing, stuck hover or focus states, broken images, and layouts that differ unexpectedly between light and dark mode.

Why does my screenshot show a missing or different background?

The ambient background has a WebGL2 renderer with a CSS fallback, so captures can differ between machines, and there is a brief moment with no background while the renderer resolves. Some pages intentionally hide the ambient layer, so let the page settle before capturing.

When should I use visual review versus design quality review?

Use visual review to catch what is broken: clipped text, invisible elements, and layout collapse. For judgments about craft, consistency, polish, and taste, use a design quality review skill instead.