visual-regression

Generates Storybook stories, Chromatic configuration, and CI workflows for visual regression testing.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill visual-regression-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-regression
Source: https://github.com/qf-studio/navigator/tree/main/skills/visual-regression
Command: npx skills add https://github.com/qf-studio/navigator --skill visual-regression-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up visual regression testing manually requires reading Storybook and Chromatic documentation, writing story files for every component variant, configuring the VR tool, and wiring up CI pipelines, which typically takes hours per project. ## Core Features & Use Cases - Automated Story Generation: Parses React, Vue, or Svelte components to extract props and variants, then generates complete .stories.tsx files with accessibility tests. - Multi-Tool Configuration: Creates configuration files for Chromatic, Percy, or BackstopJS and updates .storybook/main.js and package.json scripts non-destructively. - CI/CD Workflow Generation: Detects GitHub Actions, GitLab CI, or CircleCI and produces ready-to-commit pipeline files with correct Node versions and package managers. - Use Case: A developer says "Set up visual regression for ProfileCard" and receives a story file with all prop variants, a chromatic.config.json, an updated Storybook config, and a GitHub Actions workflow in minutes. ## Quick Start Ask the assistant to set up visual regression testing for a specific component such as src/components/ProfileCard.tsx using Chromatic.

Frequently Asked Questions about visual-regression

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

FAQPage Schema
How do I set up visual regression testing with Storybook?

Invoke the skill with a component path and it validates your Storybook setup, generates a .stories.tsx file with all prop variants, creates the VR tool configuration, and adds a CI workflow. You then install the listed dependencies and add your project token as a CI secret.

Chromatic vs Percy vs BackstopJS for visual regression?

Chromatic is purpose-built for Storybook with component-focused testing and a free tier of 5,000 snapshots per month. Percy supports multiple frameworks with responsive testing, while BackstopJS is open source and self-hosted but requires more manual setup.

Can I add Chromatic to an existing Storybook project?

Yes, the skill detects existing Storybook configurations and story files, then only adds the @chromatic-com/storybook addon to .storybook/main.js without modifying existing stories. It generates the Chromatic config and CI workflow around your current setup.

Does visual regression setup work with Vue or Svelte components?

The skill supports React, Vue, and Svelte, detecting the framework from package.json dependencies. React components get full prop analysis with TypeScript interfaces, while Vue and Svelte receive simplified story templates.

Why does the visual regression setup validation fail?

Validation fails when Storybook is not installed, the framework is not detected in package.json, or the component file path is invalid. Install Storybook first with npx storybook init, then retry with a valid component path.