skills.rest
alinaqi
alinaqiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Visual Validation — Autonomous Screenshot Verification

Compares Peekaboo screenshots with AI to detect visual regressions.

705|56|Updated Dec 26, 2025
Search Tags:#visual regression#dashboard testing#peekaboo#gemini flash#ui quality#baseline comparison#screenshot verification
One-click install
npx skills add https://github.com/alinaqi/maggy --skill visual-validation-autonomous-screenshot-verification
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Visual Validation — Autonomous Screenshot Verification
Source: https://github.com/alinaqi/maggy/tree/main/skills/visual-validation
Command: npx skills add https://github.com/alinaqi/maggy --skill visual-validation-autonomous-screenshot-verification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents visual regressions by replacing subjective “looks good” checks with automated screenshot comparison that flags unintended UI changes.

Core Features & Use Cases

  • Pixel-accurate screenshot capture: Uses Peekaboo to capture deterministic before/after images (screen-wide or focused windows) for UI changes.
  • Baseline comparison with AI triage: Compares the latest screenshot against prior baselines and uses Gemini Flash to identify whether changes are clean or regression-level.
  • Autonomous workflow integration: Leverages an auto-review hook for static/ changes and a testkit plugin for visual regression checks during POST /api/testkit/run, plus optional build-in-public capture.

Quick Start

Ask an assistant to run a verification cycle by capturing a new Peekaboo screenshot after your static/ change, comparing it to the latest baseline in ~/.maggy/visual-verify/, and then using Gemini Flash to report whether the result is CLEAN or REGRESSION_DETECTED with specific issues.

Frequently Asked Questions about Visual Validation — Autonomous Screenshot Verification

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

FAQPage Schema
How do I automate visual regression testing for web dashboard UI changes?▼

Automate visual regression testing by capturing deterministic before/after screenshots with Peekaboo, storing baselines, and using Gemini Flash to compare pixel differences and report CLEAN or REGRESSION_DETECTED.

What is the best way to verify UI changes before release without manual checks?▼

The best way to verify UI changes is using autonomous screenshot verification, which replaces subjective manual checks with pixel-level baseline comparison and AI triage to flag unintended visual regressions.

Can I use Gemini Flash for detecting visual regressions in product UI workflows?▼

Yes, Gemini Flash is used for visual regression analysis by evaluating screenshot diffs against prior baselines and autonomously reporting whether the UI changes are clean or contain regression-level issues.

How do I run a screenshot verification cycle after updating static assets?▼

Run a screenshot verification cycle by capturing a new Peekaboo screenshot after your static change, comparing it to the latest baseline in ~/.maggy/visual-verify/, and using Gemini Flash to report the result.

Does visual regression testing work with autonomous workflow integration and API hooks?▼

Yes, visual regression testing integrates autonomously via an auto-review hook for static changes and a testkit plugin for visual checks during POST /api/testkit/run, plus optional build-in-public capture.

What are the limitations of using screenshot diffs for UI quality validation?▼

Screenshot diff validation is limited to pixel-level visual changes and requires deterministic before/after captures, meaning it focuses on visual regressions rather than underlying functional or logic UI errors.

Related Skills

Explore More Design & Creative Skills→
edonghyunedonghyun
1

compare

Compare baseline and current UI captures into a side-by-side visual report.

Community
Advanced
finlaysonstudiofinlaysonstudio
2

test

Standardize Vitest testing workflows across JavaScript monorepo packages.

Official
Intermediate
tiancaiamaotiancaiamao
5

peekaboo

Operates a CLI to capture, inspect, and control macOS UI elements.

Community
Advanced
act70255act70255

ui-visual-validator

Validate UI components for visual consistency, design system compliance, and accessibility.

Community
Advanced