web-visual-qa

Verify built web pages visually by capturing screenshots and analyzing rendered pixels.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill web-visual-qa-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-visual-qa
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/web-visual-qa
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill web-visual-qa-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? A clean build and zero console errors only prove a page renders, not that it looks right. This Skill closes the gap between "it compiles" and "it looks good" by requiring real screenshot capture and vision-based review before any web or UI task is declared complete. ## Core Features & Use Cases - Pixel-based verification pipeline: Serve the page over HTTP, screenshot it with Playwright MCP, crop and shrink regions with PIL, host on a public URL, and run vision analysis on the actual pixels. - Interactive DOM verification: Exercise every feature via Playwright's browser_evaluate (clicking calculator keys, reading live-updating values) to prove apps launch, render, and respond. - Deterministic fallback: When no browser is reachable, extract the page's script, run node --check, and unit-test pure functions in Node, then honestly report "logic verified, pixels not captured." - Use Case: You just built a landing page the user asked to look "premium, not AI slop." Instead of reporting done after a DOM probe, you screenshot the hero and each section, run vision with specific quality questions about typography, spacing, and color, and fix issues before presenting. ## Quick Start Use the web-visual-qa skill to screenshot the page I just built and verify it looks right before we call it done.

Frequently Asked Questions about web-visual-qa

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

FAQPage Schema
How do I visually verify a web page with Playwright screenshots?▼

Serve the page over HTTP with python -m http.server since Playwright blocks file:// URLs, then take a screenshot via the Playwright MCP browser_take_screenshot tool. Crop and shrink the image with PIL, host it on a public URL, and run vision analysis on it.

How to test interactive web app features without screenshots?▼

Use Playwright's browser_evaluate to run JavaScript in the live page context: click elements, call page-defined functions, and read resulting DOM state. This proves apps launch and respond, though it does not verify visual quality like spacing or typography.

Why can't vision_analyze read my local screenshot file?▼

vision_analyze fetches images by URL from a remote service, so local paths, localhost URLs, and imgur hotlinks all fail. Host the image on a public GitHub raw URL or another direct public image link before calling it.

What causes horizontal overflow on mobile web layouts?▼

CSS grid items default to min-width:auto, so a wide child like a table or code block forces the whole grid wider than the viewport. Fix it by adding min-width:0 to grid children and giving wide content its own overflow-x:auto scroll container.

What should I do when Playwright MCP becomes unreachable mid-session?▼

Fall back to deterministic checks: extract the page's script and run node --check for syntax, then unit-test pure functions in Node with explicit assertions. Report honestly that logic was verified but pixels were not captured.