visual-adjust

Compare rendered UI screenshots against ground-truth references to identify layout discrepancies.

17|3|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/ksleungac/pids-jre-simulator --skill visual-adjust
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: visual-adjust
Source: https://github.com/ksleungac/pids-jre-simulator/tree/main/.claude/skills/visual-adjust
Command: npx skills add https://github.com/ksleungac/pids-jre-simulator --skill visual-adjust

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visually iterate on UI layouts by comparing rendered screenshots against ground-truth references, helping teams achieve pixel-perfect alignment faster.

Core Features & Use Cases

  • Side-by-side and composite comparison workflows to validate layout accuracy across fonts and display modes.
  • Step-by-step guidance for identifying discrepancies in font size, spacing, alignment, and color rendering.
  • Use Case: A designer adjusts the upper and lower LCD rendering to match a reference photo for a new UI skin.

Quick Start

Run the reference comparison workflow to align the UI rendering with the ground-truth screenshot.

Frequently Asked Questions about visual-adjust

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

FAQPage Schema
How do I compare rendered UI output against a ground-truth reference image?▼

Identifying UI layout discrepancies requires comparing rendered screenshots against ground-truth references using configurable layout parameters. This process highlights differences in font size, spacing, alignment, and color rendering during iterative design and debugging.

What do I need to debug pixel-accurate UI layout discrepancies?▼

Debugging pixel-accurate UI layout discrepancies requires access to the renderer code (such as upper_lcd.py), a ground-truth image, and a reproducible workflow. These elements generate comparisons with configurable layout parameters to validate alignment across display modes and font variants.

Can I use this approach to iterate on UI rendering for different font variants?▼

Yes, you can use this approach to iterate on UI rendering for different font variants. The workflow supports side-by-side and composite comparisons to validate layout accuracy and identify discrepancies across multiple display modes and font variants.

What's the best way to achieve pixel-perfect UI alignment against a reference photo?▼

The best way to achieve pixel-perfect UI alignment is to run the reference comparison workflow. This guides you step-by-step to identify and correct discrepancies in font size, spacing, alignment, and color rendering between the rendered output and the ground-truth screenshot.

Does visual layout comparison work with Pygame renderer code?▼

Yes, visual layout comparison works with Pygame renderer code. The workflow requires access to your renderer code (like upper_lcd.py) and a ground-truth image to generate comparisons and validate on-screen element alignment across different display modes.