train-visual-qa

Evaluate visual-qa prompts against labeled mobile UI screenshots for defect detection.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/thomasttvo/claude-skills --skill train-visual-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: train-visual-qa
Source: https://github.com/thomasttvo/claude-skills/tree/main/skills/train-visual-qa
Command: npx skills add https://github.com/thomasttvo/claude-skills --skill train-visual-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures visual-qa analysis prompts reliably detect layout and spacing defects in mobile UI screenshots by automating evaluation against labeled test cases and preventing regressions caused by ad-hoc prompt edits.

Core Features & Use Cases

  • Automated Test Harness: Loads captured test cases with expected signals and known false positives, runs the visual-qa prompt against each screenshot, and collects outputs for scoring.
  • Deterministic Scoring: Compares outputs to ground truth to mark FOUND/MISSED signals and AVOIDED/FLAGGED false positives, applying an 80%+ pass threshold and zero flagged known false positives as pass criteria.
  • Iterative Prompt Tuning: Guides structural prompt changes, re-runs the full suite to detect regressions, and repeats until results stabilize or iteration limits are reached.
  • Use Case: Fine-tune a visual-qa analysis prompt to consistently find spacing and layout defects across a library of mobile screenshots before deploying to production QA pipelines.

Quick Start

Run the visual-qa trainer to evaluate the visual-qa prompt against the training test cases and iterate until pass criteria are met.

Frequently Asked Questions about train-visual-qa

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

FAQPage Schema
How do I automate visual QA testing for mobile UI screenshot layout defects?

Automated visual QA testing for mobile UI screenshots works by running analysis prompts against labeled test cases to detect layout and spacing defects. The system collects outputs, scores them against ground truth, and applies an 80% pass threshold with zero flagged false positives.

How do I evaluate and tune image analysis prompts for consistent test automation results?

Evaluating image analysis prompts involves running them against a library of captured test cases and computing FOUND/MISSED and AVOIDED/FLAGGED metrics. Iterative prompt tuning applies structural changes and re-runs the full suite to detect regressions until results stabilize or iteration limits are reached.

What is needed to set up an automated test harness for UI testing screenshot analysis?

Setting up an automated test harness for UI testing requires captured test cases with expected signals, the visual-qa prompt content, and an ask_screen execution environment to run analyses and compute scoring metrics.

Why does my visual QA prompt miss spacing defects after ad-hoc prompt edits?

Visual QA prompts miss spacing defects after ad-hoc edits because untracked changes introduce regressions. Automated evaluation against labeled test cases prevents this by verifying defect detection accuracy and ensuring consistent results across all captured mobile screenshots.

Can I use this visual-qa trainer for automated pipelines beyond mobile UI screenshots?

The visual-qa trainer is specifically designed for mobile UI screenshot QA workflows and automated pipelines that require consistent detection of spacing and layout issues. It applies deterministic scoring to verify defect detection accuracy across many captured test cases.

What are the pass criteria for visual QA prompt evaluation in test automation?

Pass criteria for visual QA prompt evaluation require an 80%+ pass threshold for detecting signals and zero flagged known false positives. The system compares outputs to ground truth to mark FOUND/MISSED signals and AVOIDED/FLAGGED false positives.