Skip to main content
skillsSource-backed

Reg-suit Visual Regression Review Capability Pack Skill

Expert reg-suit review skill for evaluating rendered UI image baselines, thresholds, snapshot storage, report artifacts, and visual QA release readiness.

Level:expertType:capability-packVerified:validated
Review first review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Source URLs
https://github.com/reg-viz/reg-suit#readme, https://github.com/reg-viz/reg-suit
Safety notes
Installing reg-suit adds npm packages to the selected project environment; pin the reviewed package version and avoid global installs for review work., reg-suit can publish image snapshots and HTML reports through storage plugins such as S3 or Google Cloud Storage; review destination configuration before running in shared CI., Visual baselines can normalize accidental UI changes if accepted too casually; require owner approval for broad layout, color, text, or viewport changes., The source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.
Privacy notes
Rendered UI images and reports can expose environment URLs, branch names, visible UI text, test account data, and product screenshots., Storage and notification plugins can publish report links to CI systems, pull request comments, chat tools, or cloud buckets., Keep public review notes focused on changed components, thresholds, artifact links, and summarized findings; omit sensitive rendered content that does not need to be public.
Platform compatibility
claude-code (native-skill), codex (native-skill), windsurf (native-skill), gemini (native-skill), cursor (adapter), cli (manual-context)
Author
oktofeesh1
Submitted by
oktofeesh1
Claim status
unclaimed
Last verified
2026-06-03

Decision playbook

Review trust signals before you adopt

Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.

Compare context
Selected

0

Current score

86

Baseline

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Complete

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done
  • Source provenance statusRequired

    Marked as source-backed.

    Done
  • Metadata reviewed

    Registry metadata indicates a reviewed listing.

    Done

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done
  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done
  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Needs review

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done
  • Package verification flag

    No package verification flag provided.

    Pending
  • Checksum metadata

    No checksum provided for downloaded artifact.

    Pending

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending
  • Baseline comparison available

    No baseline peer selected yet.

    Pending
  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

Package install

Copy-ready — paste the snippet to get started.

Adoption plan

Balanced adoption plan

Current risk score 16/100. Use staged verification before broader rollout.

Risk 16

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done
  • Confirm metadata review state

    Listing has review metadata.

    Done
  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done
  • Review privacy notesRequired

    Privacy notes are present.

    Done
  • Verify package integrity metadata

    No package verification/checksum metadata.

    Pending

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending
  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending
  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Required evidence gates are covered (5/6 signals complete).

Risk 15

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Present

Review metadata is present.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Missing

Package integrity metadata is missing.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required evidence gates are covered for this preset.

Decision timeline

Decision timeline · balanced

5/6 steps complete with no blocking gaps for this preset.

Risk 14

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is available.

Done

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is missing.

Pending

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

No required blockers for this timeline preset.

Prerequisite readiness

Prerequisite readiness

5 prerequisites to line up before setup. Includes a review or approval gate.

0/5 ready
Configuration1Network & hosting1Review & approval1General2

Safety & privacy surface

Safety & privacy surface

4 safety and 3 privacy notes across 3 risk areas. Review closely: network access.

3 areas
  • SafetyExecution & processesInstalling reg-suit adds npm packages to the selected project environment; pin the reviewed package version and avoid global installs for review work.
  • SafetyExecution & processesreg-suit can publish image snapshots and HTML reports through storage plugins such as S3 or Google Cloud Storage; review destination configuration before running in shared CI.
  • SafetyGeneralVisual baselines can normalize accidental UI changes if accepted too casually; require owner approval for broad layout, color, text, or viewport changes.
  • SafetyGeneralThe source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.
  • PrivacyGeneralRendered UI images and reports can expose environment URLs, branch names, visible UI text, test account data, and product screenshots.
  • PrivacyNetwork accessStorage and notification plugins can publish report links to CI systems, pull request comments, chat tools, or cloud buckets.
  • PrivacyGeneralKeep public review notes focused on changed components, thresholds, artifact links, and summarized findings; omit sensitive rendered content that does not need to be public.

Safety notes

  • Installing reg-suit adds npm packages to the selected project environment; pin the reviewed package version and avoid global installs for review work.
  • reg-suit can publish image snapshots and HTML reports through storage plugins such as S3 or Google Cloud Storage; review destination configuration before running in shared CI.
  • Visual baselines can normalize accidental UI changes if accepted too casually; require owner approval for broad layout, color, text, or viewport changes.
  • The source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.

Privacy notes

  • Rendered UI images and reports can expose environment URLs, branch names, visible UI text, test account data, and product screenshots.
  • Storage and notification plugins can publish report links to CI systems, pull request comments, chat tools, or cloud buckets.
  • Keep public review notes focused on changed components, thresholds, artifact links, and summarized findings; omit sensitive rendered content that does not need to be public.

Prerequisites

  • UI change, pull request, or release candidate with rendered image artifacts
  • reg-suit configuration such as `regconfig.json`
  • Baseline image source, actual image directory, and generated report location
  • Threshold policy for accepted pixel or rate differences
  • CI logs, storage configuration, and reviewer policy for accepting baseline changes

Schema details

Install type
package
Reading time
9 min
Troubleshooting
Yes
Source repository stats
Scope
Source repo
Skill and platform metadata
Skill type
capability-pack
Skill level
expert
Verification
validated
Verified at
2026-06-03
Retrieval sources
https://github.com/reg-viz/reg-suit#readmehttps://github.com/reg-viz/reg-suit/releases/tag/v0.14.6https://registry.npmjs.org/reg-suit/0.14.5https://raw.githubusercontent.com/reg-viz/reg-suit/v0.14.6/README.mdhttps://raw.githubusercontent.com/reg-viz/reg-suit/v0.14.6/package.jsonhttps://raw.githubusercontent.com/reg-viz/reg-suit/v0.14.6/packages/reg-suit-cli/package.json
Tested platforms
ClaudeCodexWindsurfGeminiCursorGeneric AGENTS
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Full copyable content
# Trigger
"Apply the reg-suit visual regression review capability pack to this UI change."

# Required output
1) reg-suit package/source version and config inventory
2) Baseline, actual image, threshold, and report review
3) Visual-diff findings with release-blocking and non-blocking issues
4) Validation plan and merge, hold, or request-changes recommendation

About this resource

Knowledge Freshness

This capability pack is pinned to reg-suit CLI package 0.14.5, the reg-suit source release v0.14.6, npm metadata, and source files verified on 2026-06-03. The source release contains packages/reg-suit-cli/package.json with package name reg-suit and version 0.14.5.

Retrieval Sources

Prefer current reg-suit source, npm metadata, and repository documentation over model memory for CLI commands, plugin names, threshold options, and report behavior.

Scope Note

This is not a Playwright E2E testing skill, a generic rendered-page workflow, or an after-edit hook. Use it for human-in-the-loop review of reg-suit visual regression artifacts: baselines, actual image sets, diff reports, thresholds, storage plugins, notification plugins, and release decisions.

Core Workflow

  1. Confirm the reg-suit package version, source release, npm metadata, repository status, and install path used for review.
  2. Locate regconfig.json and inventory core.workingDir, core.actualDir, thresholdRate, thresholdPixel, matchingThreshold, antialias handling, x-img-diff settings, and concurrency.
  3. Inventory configured plugins: key generator, publisher, notifier, storage destination, report destination, and pull request notification behavior.
  4. Confirm the baseline source, actual image source, expected branch or commit key, and whether the comparison target matches the release branch.
  5. Review generated reports for changed regions, inserted or moved areas, missing images, viewport-specific drift, font rendering changes, and component-level ownership.
  6. Classify visual changes as intentional, suspicious, release-blocking, flaky capture, environment mismatch, or baseline-maintenance noise.
  7. Review threshold policy. Check whether thresholds mask meaningful UI changes or fail harmless rendering variation.
  8. Build a validation plan: recapture steps, targeted page checks, owner review, usability spot checks when visual changes affect text or controls, and CI reruns for flaky captures.
  9. Produce a release recommendation with evidence links, accepted baseline list, blockers, follow-up owners, and a merge, hold, or request-changes decision.

Capability Scope

  • reg-suit package/source verification
  • regconfig.json and plugin review
  • Baseline and actual image provenance review
  • Threshold and antialias policy review
  • HTML report and visual diff triage
  • Storage and notification behavior review
  • CI visual QA gate review
  • Evidence-based release decision for UI changes

Compatibility

Native

  • Claude Code / Claude: use as a reusable Agent Skill for visual regression review and release gating.
  • Codex/OpenAI workflows: use as SKILL.md-style instructions for UI artifact review.

Manual Adaptation

  • Windsurf and Gemini: adapt the workflow and output contract into their skill formats.
  • Cursor and Generic AGENTS files: convert the review rules and validation checklist into repository-level visual QA instructions.

Required Inputs

  • reg-suit package version and source release
  • Pull request, release candidate, or UI change summary
  • regconfig.json and configured plugin list
  • Baseline image source and actual image directory
  • Generated report URL or local report path
  • Threshold policy and owner approval rules for accepting new baselines

Production Rules

  • Do not accept a new baseline until the visual change is tied to an intentional product or design change.
  • Do not treat a low diff percentage as safe when the changed region affects navigation, forms, prices, permissions, or critical calls to action.
  • Do not approve broad baseline churn when only one component was expected to change.
  • Treat missing, blank, clipped, overlapped, or wrong-viewport images as release-blocking until recaptured.
  • Keep visual review separate from functional test results; passing E2E tests do not prove the UI rendered correctly.
  • Require storage and notification destinations to be explicit before publishing visual reports from CI.
  • Prefer targeted recapture and owner review over raising thresholds to make a noisy run pass.

Output Contract

  1. Source evidence: reg-suit package version, source release, npm metadata, repo links, and docs reviewed.
  2. Config inventory: actual directory, working directory, thresholds, x-img-diff settings, plugins, storage, and notifications.
  3. Artifact review: baseline source, actual image set, report location, changed images, and changed regions.
  4. Findings: release blockers, non-blocking visual issues, flaky capture symptoms, and accepted intentional changes.
  5. Validation plan: exact recapture, CI, owner-review, and targeted page checks needed before merge.
  6. Recommendation: merge, hold, request changes, or recapture with evidence.

Troubleshooting

Issue: The report shows widespread pixel drift

Fix: Check rendering environment, fonts, viewport size, animation state, and capture timing before accepting a broad baseline update.

Issue: The target branch has no expected images

Fix: Review the key generator plugin, branch/commit key, storage destination, and CI checkout depth before treating every image as new.

Issue: Thresholds hide meaningful changes

Fix: Lower the threshold or split critical pages into stricter scenarios. Escalate changes affecting navigation, forms, pricing, permissions, or primary actions.

Issue: Report links are unavailable after CI finishes

Fix: Check publisher plugin settings, bucket permissions, report retention, and whether notification plugins point reviewers to the same report generated by the run.

Issue: Baselines keep changing without product changes

Fix: Stabilize fonts, viewport, locale, time, seeded data, animation state, and network fixtures before approving new images.

Validation Checklist

  • reg-suit package version, source release, npm metadata, and docs verified.
  • regconfig.json found and reviewed.
  • Baseline source and actual image directory identified.
  • Thresholds and antialias settings checked against project policy.
  • Storage and notification plugins inventoried.
  • Changed images and changed regions reviewed.
  • Missing, blank, clipped, and wrong-viewport captures checked.
  • Intentional visual changes tied to product or design evidence.
  • Recapture and owner-review requirements documented.
  • Merge, hold, request-changes, or recapture recommendation recorded.

Source citations

Add this badge to your README

Show that Reg-suit Visual Regression Review Capability Pack Skill is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/skills/reg-suit-visual-regression-review-capability-pack.svg)](https://heyclau.de/entry/skills/reg-suit-visual-regression-review-capability-pack)

How it compares

Reg-suit Visual Regression Review Capability Pack Skill side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

Field

Expert reg-suit review skill for evaluating rendered UI image baselines, thresholds, snapshot storage, report artifacts, and visual QA release readiness.

Open dossier

Expert Vitest coverage planning skill for choosing providers, scoping reports, setting thresholds, triaging gaps, and designing practical coverage gates.

Open dossier

Expert Spectral review skill for auditing OpenAPI contracts, OAS rulesets, lint results, schema drift, CI gates, and API release readiness.

Open dossier

Expert Renovate review skill for evaluating dependency upgrade PRs, package rules, lockfile changes, grouping, automerge, and release readiness.

Open dossier
Next steps
Trust
Review statusReviewedMaintainer reviewedReviewedMaintainer reviewedReviewedMaintainer reviewedReviewedMaintainer reviewed
Package trustPackage not verifiedPackage not verifiedPackage not verifiedPackage not verified
Source provenanceSubmission linkedSource submissionSubmission linkedSource submissionSubmission linkedSource submissionSubmission linkedSource submission
Submitteroktofeesh1oktofeesh1oktofeesh1oktofeesh1
Install riskReview firstReview firstReview firstReview first
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
Brand
Categoryskillsskillsskillsskills
SourceSource-backedSource-backedSource-backedSource-backed
Authoroktofeesh1oktofeesh1oktofeesh1oktofeesh1
Added2026-06-032026-06-032026-06-032026-06-03
Platforms
Harness
Source repo
Safety notesInstalling reg-suit adds npm packages to the selected project environment; pin the reviewed package version and avoid global installs for review work. reg-suit can publish image snapshots and HTML reports through storage plugins such as S3 or Google Cloud Storage; review destination configuration before running in shared CI. Visual baselines can normalize accidental UI changes if accepted too casually; require owner approval for broad layout, color, text, or viewport changes. The source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.Installing Vitest and coverage providers adds npm packages to the selected project environment; pin reviewed versions and use project-local installs. Coverage runs execute the project test suite and can use test fixtures, network mocks, databases, or generated artifacts configured by the project. Vitest coverage can clean the configured reports directory before a run; confirm the reports directory is disposable before enabling coverage in shared workflows. Threshold changes can block or unblock CI; review threshold updates separately from test additions. The source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.Installing Spectral adds npm packages to the selected project environment; pin the reviewed version and avoid global installs for review work. Spectral can lint local files, globs, and remote contract URLs; review source locations before running checks in shared CI. Ruleset changes can silently weaken future API gates; review disabled rules, severity changes, and overrides as release-impacting changes. JavaScript rulesets and custom functions such as `.spectral.js` execute Node.js code; do not run attacker-supplied rulesets from untrusted PRs unless they have been inspected and executed in a sandboxed environment. The source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.Installing Renovate adds an npm package to the selected project environment; pin the reviewed version and avoid global installs for review work. Renovate can update dependency manifests and lockfiles; review generated diffs before approving automerge or grouped updates. Major upgrades, runtime dependencies, toolchain changes, and lockfile churn should be treated as release-blocking until tests and smoke checks pass. The source ZIP is external and version-pinned for reference; package trust should remain a maintainer decision.
Privacy notesRendered UI images and reports can expose environment URLs, branch names, visible UI text, test account data, and product screenshots. Storage and notification plugins can publish report links to CI systems, pull request comments, chat tools, or cloud buckets. Keep public review notes focused on changed components, thresholds, artifact links, and summarized findings; omit sensitive rendered content that does not need to be public.Coverage output can reveal source paths, module names, uncovered function names, branch structure, report file names, and project layout. HTML, JSON, LCOV, and JUnit artifacts can include snippets, line ranges, and package structure from the reviewed project. Keep public review notes focused on aggregate gaps, file groups, risk areas, and validation commands; omit sensitive implementation details that do not need to be public.OpenAPI files can reveal internal route names, hostnames, example payloads, business object names, and planned endpoints. Lint reports can include source paths, schema paths, rule names, snippets, and examples from the reviewed contract. Keep public review notes focused on rule IDs, contract paths, compatibility impact, and summarized examples; omit details that do not need to be public.Dependency metadata can reveal package names, repository layout, branch names, internal registry hosts, and release cadence. Keep public review notes focused on package names, versions, config keys, and test results; omit operational details that do not need to be public.
Prerequisites
  • UI change, pull request, or release candidate with rendered image artifacts
  • reg-suit configuration such as `regconfig.json`
  • Baseline image source, actual image directory, and generated report location
  • Threshold policy for accepted pixel or rate differences
  • JavaScript or TypeScript project using Vitest or evaluating a Vitest coverage gate
  • Test command, package manager, and `vitest.config` or Vite config
  • Current coverage report, changed-file context, or uncovered source inventory
  • Project risk areas, owner expectations, and release policy for test gaps
  • OpenAPI v2, v3.0, or v3.1 contract file set
  • Spectral ruleset such as `.spectral.yaml` or an explicit ruleset path
  • Lint output, CI output, or proposed contract diff
  • API owner expectations for breaking changes, naming, examples, and release gates
  • Renovate dependency upgrade PR, config diff, or dependency dashboard item
  • Dependency manifest and lockfile diff for the reviewed package manager
  • Renovate config source such as `renovate.json`, package config, or inherited presets
  • Release notes, changelog, package metadata, or source tag for the updated dependency
Install
npm install --save-dev reg-suit@0.14.5
npm install --save-dev vitest@4.1.8 @vitest/coverage-v8@4.1.8
npm install --save-dev @stoplight/spectral-cli@6.15.0
npm install --save-dev renovate@43.210.1
Config
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed
Open 4 picks in the interactive comparison tool

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.