Terminal
Terminal/Skill
Generates CI pipeline config that runs Chromatic visual tests on every push, for GitHub Actions, GitLab, CircleCI, Jenkins and others.
By Chromatic
Works with
npx skills add chromaui/chromatic-skills --skill chromatic-setup-ciSet up Chromatic visual testing automation in CI/CD pipelines.
This skill is the single source of truth for:
reference/ci-detection.md to identify the CI provider from existing config files.reference/package-manager.md and detect the package manager from lockfiles.reference/docs-map.md and fetch it with WebFetch.package.json for a chromatic devDependency and script — add them if missing. Skip this step for GitHub Actions.reference/output-contract.md.Check for existing CI config files using reference/ci-detection.md.
If no CI files exist or detection is ambiguous, ask: "Which CI provider are you using? (GitHub Actions, GitLab, Bitbucket Pipelines, CircleCI, Jenkins, Azure Pipelines, or other)"
Never assume GitHub Actions unless evidence supports it.
Use reference/package-manager.md to identify the package manager from lockfiles. Use its install command and run command throughout the generated config. If an existing CI config is already present, match whatever install command it already uses.
If a CI config file already exists, read it before generating any changes. Understand the existing job structure, Node.js setup steps, and caching approach — match the project's existing patterns when adding Chromatic.
Look up the docs URL in reference/docs-map.md and fetch it with WebFetch. Use the fetched content as the authoritative source for configuration examples and requirements.
If the fetch fails, fall back to the CI overview doc: https://www.chromatic.com/docs/llms/ci.txt
GitHub Actions: The chromaui/action runs Chromatic internally — do not add a chromatic script or devDependency to package.json.
All other providers: Check package.json for a chromatic devDependency and script. If missing, add both:
"devDependencies": {
"chromatic": "^12.0.0"
},
"scripts": {
"chromatic": "chromatic --exit-zero-on-changes"
}
Always return the setup checklist from reference/output-contract.md, then show complete generated file content for copy-paste.
reference/ci-detection.mdreference/package-manager.mdreference/docs-map.mdreference/output-contract.md