Terminal
Terminal/Skill
Diagnoses Chromatic baseline mistakes caused by git history, pull request events, merge queues or CI checkout settings, such as a missing ancestor build.
By Chromatic
Works with
npx skills add chromaui/chromatic-skills --skill chromatic-workflow-debugPublic-safe skill for debugging how Chromatic maps CI, git history, and prior builds into comparisons and baselines.
This package is the single source of truth for:
reference/workflow-playbook.md and identify the current workflow phase.reference/diagnosis-taxonomy.md and choose the strongest diagnosis code the evidence supports.reference/evidence-ladder.md and decide whether you can answer now or need one more artifact.reference/command-catalog.md only when the current evidence is insufficient.reference/output-contract.md.reference/docs-map.md.Prefer evidence already provided:
branchName, repositorySlug, patchBuild, or ignoreLastBuildOnBranchDo not ask for a broad dump if the current evidence already points to one branch of the decision tree.
Choose one primary workflow diagnosis code from reference/diagnosis-taxonomy.md.
If multiple signals exist, prioritize:
Ask for exactly one next artifact or one targeted command result.
Typical next artifacts:
actions/checkout step or equivalent CI checkout snippetgit branch --show-currentgit rev-parse HEADgit log --oneline --decorate -n 10git merge-base <head> <base>Do not jump straight to Storybook flags or TurboSnap suppression flags unless the workflow evidence already cleared the git branch.
If the current run cannot compute the intended comparison safely, say so plainly.
Examples:
pull_request merge commit can point Chromatic at the wrong SHA or branch unless the action passes the correct valuesignoreLastBuildOnBranch or a fresh baseline pathAlways return the diagnosis card from reference/output-contract.md.
If confidence is still low:
reference/workflow-playbook.mdreference/diagnosis-taxonomy.mdreference/evidence-ladder.mdreference/command-catalog.mdreference/output-contract.mdreference/docs-map.mdtemplate.mdexamples/pr-merge-commit.mdexamples/rebase-replacement-build.mdevaluations/README.md