skills.rest
parisgroup-ai
parisgroup-aiOFFICIAL
Explore all skills by this author →
GitHub

maestro-capture

Capture iOS Simulator screenshots and compare them to design prototype PNGs.

1|2|Updated Apr 6, 2026
Search Tags:#ios#simulator#ui-testing#screenshot#expo#maestro#visual-compare
One-click install
npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill maestro-capture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maestro-capture
Source: https://github.com/parisgroup-ai/imersao-ia-setup/tree/main/skills/maestro-capture
Command: npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill maestro-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capturing consistent screenshots from an iOS Simulator and manually comparing them to design prototypes is time-consuming and error-prone, especially when navigation requires scripted flows and temporary automation artifacts.

Core Features & Use Cases

  • Automates validating the simulator state and verifying the app is running before capture.
  • Generates temporary Maestro navigation flows to reach target screens, runs Maestro to navigate, and captures high-fidelity simulator screenshots.
  • Optionally reads a matching prototype PNG from the design folder and provides a structured gap analysis covering layout differences, missing elements, and style mismatches.
  • Use case: QA engineers or mobile developers verifying the "settings" or "inbox" screens of a React Native app running in Expo across design handoff.

Quick Start

Use the maestro-capture skill to capture the named section from the iOS simulator and optionally compare it to the prototype image using the --compare flag.

Frequently Asked Questions about maestro-capture

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

FAQPage Schema
How do I capture iOS simulator screenshots and compare them to design prototypes?▼

Capture simulator screenshots by running Maestro flows to navigate the app and using xcrun simctl to capture the screen, then optionally compare the captured image against a prototype PNG to identify layout differences, missing elements, and style mismatches.

What is the best way to automate UI testing screenshots for an Expo iOS app?▼

Automating UI testing screenshots for an Expo iOS app involves generating temporary Maestro flows to navigate screens, verifying the app is running under host.exp.Exponent, and capturing high-fidelity simulator screens with xcrun simctl.

Does maestro-capture work with React Native apps running in an Expo simulator?▼

Yes, maestro-capture works with React Native apps running in an Expo simulator by validating the simulator state and verifying the app is running under the host.exp.Exponent context before capturing screens.

How do I find visual gaps between my iOS app UI and design images?▼

To find visual gaps between your iOS app UI and design images, capture a simulator screenshot using Maestro flows and xcrun simctl, then compare it against a matching prototype PNG located in the design/sections directory to receive structured layout and style analysis.

Do I need xcrun simctl and Maestro CLI to capture simulator screens?▼

Yes, you need xcrun simctl to capture the iOS simulator screenshots and the Maestro CLI to run the navigation flows that reach target screens like inbox, projects, or settings before the capture occurs.

Where should I place prototype images for visual comparison during iOS UI testing?▼

You should place prototype images as PNG files under the design/sections/<section>/ directory so they can be matched with the corresponding captured iOS simulator screens for a structured gap analysis.

Related Skills

Explore More Software Engineering Skills→
Roy-wonjiRoy-wonji

simulator-utils

Resize iOS Simulator screenshots and run simctl device and app workflows.

Community
Intermediate
LykhoydaLykhoyda
10

rn-testing

Automate React Native UI and end-to-end tests with Maestro and maestro-runner.

Community
Advanced
telum-aitelum-ai
2

visual-testing-mobile-react-native

Generates deterministic screenshots for React Native and Expo visual regression testing across iOS and Android via Maestro, Detox, ADB, and simctl.

Official
Intermediate
joi-fairsharejoi-fairshare
1

design-verify-ios

Validate iOS simulator screenshots against approved mockups to detect visual UI drift.

Community
Advanced