visual-verify

Automate UI verification across mobile, web, and macOS platforms.

42|1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/kesteva/soloflow --skill visual-verify-kesteva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-verify
Source: https://github.com/kesteva/soloflow/tree/main/skills/visual-verify
Command: npx skills add https://github.com/kesteva/soloflow --skill visual-verify-kesteva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually verifying UI changes across mobile, web, and native macOS platforms is time-consuming, error-prone, and requires constant context switching between different tools and devices, creating unnecessary friction for solo developers working on cross-platform products.

Core Features & Use Cases

  • Multi-platform visual verification: Natively supports mobile (via Maestro MCP or CLI), web (via Playwright MCP), and native macOS apps (via Peekaboo MCP or CLI) with automatic fallback to the best available tool for each platform.
  • Intelligent preflight checks: Runs dev server availability probes and single-path selection logic upfront to avoid wasted runs, token spend, and port contention from conflicting tool calls.
  • Structured result mapping: Automatically aligns visual checks to acceptance criteria from task plans for clear, actionable pass/fail reporting that integrates with sprint workflows. Use case: A solo developer shipping a cross-platform productivity app can use this skill to automatically confirm that a new dashboard layout renders correctly on iOS, the web app, and the macOS native client after a code change, without manually opening each app and inspecting every element.

Quick Start

Use the visual-verify skill to confirm the new settings page UI renders correctly across your iOS simulator, web app, and macOS native app after merging the latest design updates.

Frequently Asked Questions about visual-verify

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

FAQPage Schema
How do I automate cross-platform visual verification for web, mobile, and macOS apps?

Cross-platform UI visual verification is automated by capturing screenshots, inspecting view hierarchies, and integrating UI drivers to confirm UI elements against acceptance criteria. This eliminates manual checks across mobile, web, and native macOS platforms.

Does visual verification work with Playwright and Maestro for web and mobile testing?

Yes, visual verification works with Playwright for web and Maestro for mobile UI testing, automatically selecting the best available tool. It also supports native macOS apps via Peekaboo, with configurable fallbacks for unavailable MCP servers.

What is the best way to verify UI changes against acceptance criteria without manual inspection?

The best way to verify UI changes without manual inspection is using structured result mapping to automatically align visual checks with task plan acceptance criteria. This provides clear pass or fail reporting that integrates directly into sprint workflows.

How do I avoid port contention when running UI automation tools across different platforms?

Port contention and conflicting tool calls are avoided by running intelligent preflight checks with single-path selection logic upfront. This probes dev server availability and prevents wasted runs before executing cross-platform UI automation.

Can I use Peekaboo for native macOS visual testing within a cross-platform workflow?

Yes, you can use Peekaboo for native macOS visual testing within a cross-platform workflow. The system integrates Peekaboo via MCP or CLI alongside Playwright and Maestro to verify UI layouts across iOS, web, and macOS without manual context switching.