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.