output-regression-doctor
Output Regression Doctor
Compare supplied visual outputs without modifying them. V1 supports single-frame PNG, JPEG and WebP, including UI screenshots. Video comparison is not implemented; do not run or invent a compare_video.py command.
Run the comparison
Identify which file is the approved baseline and which is current. If ambiguous, ask before interpreting the direction of change. Establish expected changes and, for screenshots, viewport, browser/OS, device scale, fonts, theme and relevant application state when available. Missing context does not prohibit measurement, but limits causal diagnosis.
Read diagnosis-rules.md before interpreting results. From this skill's directory run:
python scripts/compare_image.py <baseline> <current> --format json --no-output
Use the local .venv/Scripts/python.exe on Windows if this package has a working virtual environment; otherwise use the user's Python 3.10+ with requirements.txt installed. Do not assume the interpreter path exists.
To retain visual evidence in a new output folder: