sg-visual-discover

Generate YAML visual test manifests by exploring web project routes and UI components.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rapidly creating and maintaining visual test manifests for web projects is time-consuming and error-prone when done manually; this Skill automates discovery of routes, interactive components, and test data to produce consistent YAML test manifests that mirror the UI navigation tree.

Core Features & Use Cases

  • Framework-aware route discovery: Detects Next.js (app/pages), React Router, Vue, Angular routes, or falls back to static HTML scanning.
  • Interactive element detection: Identifies forms, modals, uploads, tabs, media, and pre-fills test steps and data fixtures.
  • Config and shared bricks generation: Creates visual-tests/_config.yaml, _shared/login.yaml, and organized manifest directories without overwriting existing files unless explicitly requested.
  • Diff and scope modes: Supports --diff to limit generation to impacted routes, --all for full discovery, and --refresh-existing to update manifests safely.
  • Dev server and credentials detection: Attempts to auto-detect build/dev server commands, dev credentials, and test assets for richer manifests.

Quick Start

Run /sg-visual-discover on your project path to scan routes, detect interactive components, and generate visual-tests YAML manifests with optional --diff or --all flags.

Frequently Asked Questions about sg-visual-discover

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

FAQPage Schema
How do I auto-generate visual test manifests for a web project?

To auto-generate visual test manifests, run the route discovery command against your project path to scan navigation and interactive elements, outputting structured YAML test manifests that mirror your UI navigation tree without manual configuration.

Does visual route discovery work with Vue and Angular projects?

Yes, visual route discovery works with Vue and Angular projects, alongside Next.js, React Router, and static HTML sites. The tool detects framework-specific routing structures to accurately map your UI navigation tree into YAML manifests.

What is the best way to update visual test manifests after code changes?

The best way to update visual test manifests after code changes is using the --diff flag to limit generation to impacted routes, or --refresh-existing to safely update manifests without overwriting your current test configurations.

Do I need agent-browser installed to generate UI test manifests?

Yes, you need agent-browser installed to generate UI test manifests, as it enables the interactive element detection required for identifying forms, modals, uploads, and tabs across your web project's routes.

Can I pre-fill test data fixtures when creating YAML test manifests?

Yes, you can pre-fill test data fixtures when creating YAML test manifests. The tool detects forms, modals, and uploads during route discovery, automatically generating test steps and data fixtures within the visual-tests directory structure.

Why does visual test manifest generation require repository access?

Visual test manifest generation requires repository access to detect your framework's routing structure, scan UI components, and identify build or dev server commands, ensuring the generated YAML manifests accurately reflect your project's actual navigation tree.