TheGoat395/Codex-Skills / skills/visual-regression-lab
visual-regression-lab
VerifiedCompare captures; stitch lazy/animated pages.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| agents/openai.yaml | config | 250 B |
| references/baseline-contract.md | markdown | 1.2 KB |
| references/stitched-full-page-capture.md | markdown | 3.4 KB |
| scripts/capture-settled-baseline.mjs | script | 6.2 KB |
| scripts/capture-stitched-full-page.mjsexecutable | script | 15.6 KB |
SKILL.md
View on GitHub---
name: visual-regression-lab
description: "Compare captures; stitch lazy/animated pages."
---
# Visual Regression Lab
Use this skill to capture comparable browser evidence and inspect visual regressions. Scope routes, viewports and states to the requested comparison; a capture alone does not prove quality.
## Required Checks
1. Start or identify the local server.
2. Open the relevant route in a browser or Playwright.
3. Capture the relevant supported viewports and states, using the same conditions for baseline and candidate.
4. Check console errors, failed requests, layout overflow, missing media, and text clipping.
5. Inspect first viewport composition, hierarchy, spacing, typography, image crops, and CTA visibility.
6. Test key interactions: nav, forms, menus, tabs, accordions, hover states, focus states, and modals.
7. For animation-heavy work, test reduced-motion behavior and watch for jank.
8. For canvas/WebGL/video, verify nonblank rendered pixels and stable framing.
9. Report observed differences with evidence. Repair only when authorized, then recapture affected states; no fixed polish-pass or edit quota applies.
Read [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.
When 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.
## 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |