Visual Verifier

visual-verifier

Visual verification agent for ROM hacks. Compares emulator screenshots against "Golden Masters" to detect regressions, glitches, or UI errors.

scawful/afs_scawful·0installs0starsProductivity & Planning

SKILL.md

Full skill instructions

Visual Verifier

Scope

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

Core Capabilities

1. Screenshot Capture

Save the current emulator frame as a reference.

capture title_screen: Saves assets/visual_masters/title_screen.png.

2. Regression Testing

Compare the current frame against a saved master.

verify title_screen: Reports similarity percentage (e.g., 99.5%).
Thresholds: Customizable (default 95%).

3. Glitch Detection (Experimental)

Analyze the frame for common SNES glitches.

Detection of "Garbage Tiles" (high-frequency noise).
Detection of "Black Screens" or "CPU Jam" visual signatures.

Workflow

Initialize: capture room_0x1B (When you know the room is correct).
Modify Code: Apply an ASM patch or change room data.
Verify: verify room_0x1B.
Result: "Similarity 85% - Red Area Detected (Check Door palette)."

Dependencies

Mesen2: Running with socket server.
Tool: ~/src/hobby/yaze/scripts/ai/visual_verifier.py.
Libs: opencv-python, Pillow.

Example Prompts

"Capture a master screenshot of the current room."
"Verify if the title screen still looks correct."
"Does the current scene match the 'dungeon_entrance' reference?"
"Check for any visual glitches on the screen."

Troubleshooting

Connection Error: Ensure Mesen2 is running.
Low Similarity: Check if animations (flicker, water) are causing noise. Capture master during a stable frame.
Resize Mismatch: Ensure emulator window hasn't been scaled or filtered unexpectedly.

Install skill

Copy and run in your terminal

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

View on GitHub

skills/visual-verifier/SKILL.md

More Productivity & Planning skills

View all

Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K

View

Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K

View

Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K

View

Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K

View

Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K

View

Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K

View

Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K

View

Productivity & Planning

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K

View