Visual Regression Lab
Use this skill to prove the site looks right in a browser, not just in code.
Required Checks
- Start or identify the local server.
- Open the relevant route in a browser or Playwright.
- Capture desktop and mobile screenshots.
- Check console errors, failed requests, layout overflow, missing media, and text clipping.
- Inspect first viewport composition, hierarchy, spacing, typography, image crops, and CTA visibility.
- Test key interactions: nav, forms, menus, tabs, accordions, hover states, focus states, and modals.
- For animation-heavy work, test reduced-motion behavior and watch for jank.
- For canvas/WebGL/video, verify nonblank rendered pixels and stable framing.
- Do one second-pass polish edit when the result feels generic or cramped.
Read baseline contract. When a project has Playwright installed, run node "<skill-root>/scripts/capture-settled-baseline.mjs" <url> <output-dir> to capture settled desktop/mobile/reduced-motion states and a machine-readable inspection manifest.
When native full-page capture is blank, sparse, incomplete, or inconsistent with real scrolling, read stitched full-page capture and run node "<skill-root>/scripts/capture-stitched-full-page.mjs" --url <url> --output <image>. Treat the stitched image as evidence only after visual inspection.
Output
Report:
- routes/viewports checked
- screenshots or saved paths when available
- issues found and fixed
- commands run
- anything not tested
Resolve <skill-root> to this skill folder's actual absolute location; preserve project-local module resolution for Node capture tools.
1---2name: visual-regression-lab3description: Compare captures; stitch lazy/animated pages.4---56# Visual Regression Lab78Use this skill to prove the site looks right in a browser, not just in code.910## Required Checks11121. Start or identify the local server.132. Open the relevant route in a browser or Playwright.143. Capture desktop and mobile screenshots.154. Check console errors, failed requests, layout overflow, missing media, and text clipping.165. Inspect first viewport composition, hierarchy, spacing, typography, image crops, and CTA visibility.176. Test key interactions: nav, forms, menus, tabs, accordions, hover states, focus states, and modals.187. For animation-heavy work, test reduced-motion behavior and watch for jank.198. For canvas/WebGL/video, verify nonblank rendered pixels and stable framing.209. Do one second-pass polish edit when the result feels generic or cramped.2122Read [baseline contract](references/baseline-contract.md). When a project has Playwright installed, run `node "<skill-root>/scripts/capture-settled-baseline.mjs" <url> <output-dir>` to capture settled desktop/mobile/reduced-motion states and a machine-readable inspection manifest.2324When native full-page capture is blank, sparse, incomplete, or inconsistent with real scrolling, read [stitched full-page capture](references/stitched-full-page-capture.md) and run `node "<skill-root>/scripts/capture-stitched-full-page.mjs" --url <url> --output <image>`. Treat the stitched image as evidence only after visual inspection.2526## Output2728Report:2930- routes/viewports checked31- screenshots or saved paths when available32- issues found and fixed33- commands run34- anything not tested3536Resolve `<skill-root>` to this skill folder's actual absolute location; preserve project-local module resolution for Node capture tools.
TheGoat395