visual-qa

Capture deterministic Playwright screenshots and diff them against stored baselines.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill visual-qa-cleanexpo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-qa
Source: https://github.com/CleanExpo/Pi-Dev-Ops/tree/main/skills/visual-qa
Command: npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill visual-qa-cleanexpo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visual QA eliminates the frustration of discovering UI breakages late by systematically capturing and comparing rendered screens, so design intent and implementation stay aligned across devices and themes.

Core Features & Use Cases

  • Multi-breakpoint screenshot capture: Generate consistent screenshots for desktop, mobile, dark mode, and custom viewport matrices to surface layout issues early.
  • Visual regression testing with diffs: Run Playwright screenshot assertions against baselines with configurable thresholds to detect meaningful pixel-level changes.
  • Design vs implementation validation: Compare current renders against DESIGN.md or reference targets to confirm styling, spacing, and state correctness.

Quick Start

Run the Playwright visual regression tests for your dashboard on Linux CI to automatically capture screenshots and fail the PR when they differ from approved baselines.

Frequently Asked Questions about visual-qa

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

FAQPage Schema
How do I detect UI visual regressions in Playwright across multiple breakpoints?

Catch UI visual regressions by capturing deterministic screenshots with Playwright and diffing them against stored baselines. This method applies configurable pixel thresholds to identify layout changes across desktop, mobile, dark mode, and custom viewport matrices during component state verification.

What is visual regression testing and how does screenshot diffing work?

Visual regression testing is the process of capturing deterministic screenshots and diffing them against approved baselines to detect pixel-level changes. It ensures design intent and implementation stay aligned across devices and themes by failing CI pipelines when meaningful differences are found.

How do I generate stable CI baselines for responsive UI verification?

Generate stable CI baselines for responsive UI verification by running Playwright on Linux CI with fonts fully loaded and animations frozen. This deterministic rendering environment ensures screenshots remain consistent for reliable visual regression diffing across breakpoints.

Can I use Playwright visual testing to validate design implementation against reference targets?

Yes, you can use Playwright visual testing to validate design implementation by comparing current renders against DESIGN.md or reference targets. This confirms styling, spacing, and state correctness by diffing screenshots to catch deviations from the intended design.

Why do my Playwright screenshot diffs fail randomly in CI pipelines?

Playwright screenshot diffs fail randomly in CI when rendering is non-deterministic due to loading fonts or active animations. Visual QA requires fonts fully loaded and animations disabled or frozen to capture stable screenshots and prevent false positive regression failures.

Do I need to disable animations for visual testing with Playwright?

Yes, you need to disable or freeze animations for visual testing with Playwright to ensure deterministic screenshot capture. Freezing animations alongside fully loaded fonts guarantees stable renders, which is required for generating reliable CI baselines and accurate screenshot diffs.