visual-qa

Validate Godot screenshots and frame sequences for visual defects and motion anomalies.

511|44|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill visual-qa-randallliuxin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: visual-qa
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/core/visual-qa
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill visual-qa-randallliuxin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-genai, openai, python, Pillow, and includes scripts (resource) components.

What problem does it solve?

This Skill removes the guesswork of judging whether a Godot scene matches visual intent by automatically checking screenshots (or frame sequences) against reference and explicit Verify criteria.

Core Features & Use Cases

  • Static Visual Verification: Compare a single game screenshot against a per-scene reference image using caller-provided Goal/Requirements/Verify context.
  • Dynamic Motion & Animation Checks: Review consecutive frames to detect motion anomalies like jitter, teleportation, stuck entities, camera issues, and timing mismatches.
  • Question-Based Visual Analysis: Answer targeted questions about one or more screenshots when no reference image is available (e.g., “Is the UI cropped and where?”).

Quick Start

Use visual-qa to check a static scene by asking an agent to run the skill with the reference image and the screenshot: “Check references/scene01.png against e2e/screenshots/scene01.png with Goal, Requirements, and Verify criteria for acceptance.”

Frequently Asked Questions about visual-qa

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

FAQPage Schema
How do I automate visual game testing for Godot screenshots?▼

Automate Godot visual game testing by validating screenshots and frame sequences against reference images and acceptance criteria. It detects visual defects, motion anomalies, and UI cropping issues using API-based visual question answering.

Can I detect jitter or teleportation issues in Godot frame sequences?▼

Detect jitter, teleportation, stuck entities, and camera timing mismatches by reviewing consecutive Godot frame captures. Dynamic motion verification analyzes 2 FPS frame sequences to identify animation anomalies blocking acceptance.

How to check a Godot UI screenshot for cropping without a reference image?▼

Check Godot UI screenshots for cropping without a reference image using question-based visual analysis. You provide targeted questions about the UI crop location, and the VQA backend evaluates the screenshot to answer acceptance-blocking queries.

Does visual question answering for Godot require specific Python dependencies?▼

Visual question answering for Godot requires Python dependencies including Pillow for image processing, alongside google-genai and openai libraries. These enable the configured VQA backend selected via the .godotmaker/config.yaml file to process screenshots.

What is the best way to verify Godot scene acceptance criteria visually?▼

Verify Godot scene acceptance criteria visually by comparing a single game screenshot against a per-scene reference image. You provide Goal, Requirements, and Verify context to the skill, which routes execution through native inspection or a Python API.