visual-verifier

Compare emulator frames against Golden Masters to detect visual regressions in ROM hacks.

Updated Dec 30, 2025

Search Tags:#emulator #regression-testing #ui-verification #visual-verification #rom-hacks #image-diffing

Ready to run

npx skills add https://github.com/scawful/afs_scawful --skill visual-verifier

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: visual-verifier
Source: https://github.com/scawful/afs_scawful/tree/main/skills/visual-verifier
Command: npx skills add https://github.com/scawful/afs_scawful --skill visual-verifier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps ROM hack projects visually consistent by automatically capturing emulator frames and comparing them against Golden Masters to detect regressions, glitches, or UI errors.

Core Features & Use Cases

Capture and manage Golden Master screenshots of game scenes.
Perform visual regression testing via image diffing.
Detect visual glitches (garbage tiles, palette errors) and verify UI state.

Quick Start

Capture a master screenshot for the current room and verify it against the master reference.

Frequently Asked Questions about visual-verifier

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

FAQPage Schema

How do I detect visual regressions in ROM hacks using emulator frames?▼

Detect visual regressions in ROM hacks by capturing emulator frames and comparing them against Golden Master screenshots to identify glitches, palette errors, or UI inconsistencies automatically.

What is image diffing for UI-state verification in retro game scenes?▼

Image diffing for UI-state verification compares current emulator frames against saved reference images using OpenCV and Pillow to detect garbage tiles, palette errors, and UI glitches.

Do I need Mesen2 and Python to perform visual regression testing on ROM hacks?▼

Visual regression testing on ROM hacks requires Mesen2 running with a socket server and Python scripts utilizing OpenCV and Pillow libraries to process and diff emulator frames.

How do I capture and manage Golden Master screenshots for retro game scenes?▼

Capture Golden Master screenshots of game scenes by running your ROM hack in the emulator, saving baseline frames as reference images, then verifying subsequent runs against them.

What's the best way to automate glitch detection across ROM hack scenes?▼

Automate glitch detection across ROM hack scenes by running a Python script that captures emulator frames via socket server and applies image diffing against Golden Masters.