visual-qa

Detect spacing and layout defects in mobile UI screenshots.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual visual inspection of mobile screenshots is slow, inconsistent, and misses subtle spacing, alignment, and touch-target issues that cause poor UX or regressions after code changes. This Skill codifies rigorous measurement rules so reviews are repeatable, objective, and actionable.

Core Features & Use Cases

  • Precise Gap Measurement: Estimates vertical and horizontal gaps as percentages of screen dimensions and converts them to points for platform-specific thresholds.
  • Alignment & Touch-target Checks: Detects misaligned row centers, baseline inconsistencies, and insufficient horizontal spacing between tap targets with severity verdicts.
  • Text Legibility & Card Consistency: Flags small or low-contrast text and enforces intra-card spacing rules to surface visual defects during PR reviews or QA passes.

Quick Start

Analyze the attached mobile screenshot for all spacing and layout defects, measure gaps and alignments in points, and return DEFECT and WARNING items with their estimated point values.

Frequently Asked Questions about visual-qa

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

FAQPage Schema
How do I detect spacing and alignment defects in mobile UI screenshots?

To detect spacing and alignment defects in mobile UI screenshots, you need a tool that measures vertical and horizontal gaps, checks touch-target spacing, and returns a summary of WARNING and DEFECT items. This process requires screen dimensions in point space and element coordinates when available.

What is mobile UI visual QA and how does it measure layout gaps?

Mobile UI visual QA is the process of validating post-change layouts by estimating vertical and horizontal gaps as percentages of screen dimensions and converting them to points. It applies platform-specific thresholds to evaluate alignment, touch targets, and intra-card spacing.

Can I check touch-target spacing and text legibility from a mobile screenshot?

Yes, you can check touch-target spacing and text legibility from a mobile screenshot by applying measurement rules that flag insufficient horizontal spacing between tap targets and low-contrast text. The analysis returns OK, WARNING, or DEFECT verdicts based on point measurements.

Does mobile UI visual QA require exact element coordinates to measure spacing?

Exact element coordinates are required when available to accurately measure spacing in point space, but the visual QA process can still estimate gaps as percentages of screen dimensions. Providing screen dimensions in point space ensures accurate platform-specific threshold checks.

What is the best way to automate row alignment checks during a mobile PR review?

The best way to automate row alignment checks during a mobile PR review is to run a visual QA pass that detects misaligned row centers and baseline inconsistencies using point measurements. The output is a focused summary listing only the DEFECT and WARNING items.

Why does manual visual inspection miss layout regressions in mobile screenshots?

Manual visual inspection misses layout regressions because it is slow, inconsistent, and lacks the rigorous measurement rules needed to spot subtle spacing and alignment issues. Codifying measurement rules ensures reviews are repeatable, objective, and actionable.