nav-component-critique

Compare header navigation screenshots and generate prioritized CSS fixes.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/aemdemos/summit-dsg --skill nav-component-critique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-component-critique
Source: https://github.com/aemdemos/summit-dsg/tree/main/.agents/skills/excat-navigation-orchestrator/nav-component-critique
Command: npx skills add https://github.com/aemdemos/summit-dsg --skill nav-component-critique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates targeted visual validation of individual header navigation components during site migrations, removing manual screenshot comparison and guesswork by producing similarity scores, difference reports, and actionable CSS/JS fixes.

Core Features & Use Cases

  • Per-component capture of source and migrated screenshots with Playwright MCP and interaction support (hover, click) for dynamic states.
  • Visual comparison scoring with a structured differences list, prioritized CSS fixes, remediation loop, and updates to style-register.json until each component reaches ≥95% similarity.
  • Orchestrator-driven parallel execution for four key components plus optional runs for skipped components; outputs include source.png, migrated.png, and critique-report.json for audit and automated remediation.
  • Use cases: validating header logo, CTA buttons, nav links row, and mobile menu panels during migration verification; running targeted fixes in header.css/header.js and re-scoring automatically.

Quick Start

Critique nav component row-0-logo to capture source and migrated screenshots, compare them, generate CSS fixes, and iterate until similarity is at least 95%.

Frequently Asked Questions about nav-component-critique

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

FAQPage Schema
How do I automate visual comparison for header navigation components during site migration?

To automate visual comparison for header navigation components during site migration, use Playwright MCP to capture source and migrated screenshots, generate similarity scores, and output prioritized CSS fixes. This removes manual screenshot comparison and guesswork from the migration workflow.

What is the best way to generate CSS fixes for mismatched navigation components?

The best way to generate CSS fixes for mismatched navigation components is to capture visual comparison scores and a structured differences list, then apply targeted fixes to header.css and header.js. The system iterates automatically until the component reaches at least 95% visual similarity.

Do I need Playwright MCP and a style-register.json file to run visual critique on migrated nav components?

Yes, you need Playwright MCP to capture screenshots and interact with DOM elements, and an existing style-register.json file to record selectors, interactions, and status. You also need the source site and the migrated site accessible at http://localhost:3000.

Can I capture dynamic states like hover and click for mobile menu panels during migration verification?

Yes, you can capture dynamic states like hover and click for mobile menu panels during migration verification. The Skill supports per-component capture with interaction support for dynamic states across desktop and mobile key components, plus optional runs for skipped components.

Why does my navigation component fail visual similarity checks after migration?

Navigation components fail visual similarity checks after migration due to CSS and JS discrepancies between the source and migrated sites. The Skill identifies these differences using screenshot comparisons and outputs a critique-report.json with a remediation loop to apply fixes until similarity reaches 95%.

What files are output when validating header logo and CTA buttons with visual comparison tools?

When validating header logo and CTA buttons with visual comparison tools, the outputs include source.png, migrated.png, and critique-report.json. These files provide audit artifacts and drive automated remediation by recording the required selectors, interactions, and visual similarity scores.