sg-visual-review

Generate an interactive HTML review page for visual test results.

7|2|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/bacoco/ShipGuard --skill sg-visual-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-visual-review
Source: https://github.com/bacoco/ShipGuard/tree/main/plugins/shipguard/skills/sg-visual-review
Command: npx skills add https://github.com/bacoco/ShipGuard --skill sg-visual-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates visual test outputs into a single interactive review page so teams can quickly find UI regressions, mark problem areas, and generate targeted re-run manifests for efficient triage and fixes.

Core Features & Use Cases

  • Build a self-contained HTML review page from YAML test manifests, visual-tests/_results/report.md, regressions data, and matched screenshots.
  • Interactive grid with status and category filters, lightbox inspection, annotation pen, multi-select, and export of re-run/fix manifests consumed by automation flows.
  • Use Case: QA or engineers reviewing a failing Visual E2E run can annotate failures, export a fix-manifest.json, and re-run only the affected tests to validate fixes.

Quick Start

Generate and open the interactive visual review page for the latest visual test results.

Frequently Asked Questions about sg-visual-review

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

FAQPage Schema
How do I review and annotate visual test screenshots from an E2E run?

You can review and annotate visual test screenshots by generating a self-contained interactive HTML page. It reads YAML manifests and regression data to provide grid browsing, lightbox inspection, and a pen tool for marking UI issues directly on screenshots.

How do I export a re-run manifest for failing visual tests?

You can export a re-run manifest for failing visual tests by using the multi-select feature in the HTML review page. Select the failing screenshots, annotate them, and save a fix-manifest.json file through the local review server endpoints for automation flows.

Does this visual testing review tool require any external dependencies?

No external dependencies are required for this visual testing review tool. It directly reads existing YAML test manifests, report.md, and _regressions.yaml files from your visual-tests directory to build the interactive review page.

Can I filter visual regressions by status and category during screenshot review?

Yes, you can filter visual regressions by status and category during screenshot review. The generated interactive HTML page includes built-in filtering options to help you quickly isolate and triage specific UI regressions from the test run.

What is the best way to triage UI regressions from visual E2E test results?

The best way to triage UI regressions from visual E2E test results is to consolidate outputs into an interactive review page. This allows teams to visually inspect regressions, annotate failures, and export targeted fix manifests to validate corrections efficiently.