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

maestro-run

Run Maestro end-to-end test flows on iOS Simulator with automatic project discovery.

1|2|Updated Apr 6, 2026
Search Tags:#e2e#test-automation#maestro#mobile-testing#ios-simulator#project-discovery#flow-runner
One-click install
npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill maestro-run
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maestro-run
Source: https://github.com/parisgroup-ai/imersao-ia-setup/tree/main/skills/maestro-run
Command: npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill maestro-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates running Maestro end-to-end mobile test flows by discovering project layout, selecting the correct flows, validating the environment, and producing structured results so developers avoid manual trial-and-error when executing tests on iOS Simulator.

Core Features & Use Cases

  • Automatic Project Discovery: Finds .maestro, maestro, or flows directories across monorepos and selects the closest project context to run.
  • Flexible Flow Resolution: Supports category names, exact flow files, fuzzy keyword matches, run-all, and interactive Studio mode for debugging.
  • Pre-flight Validation & Structured Results: Verifies Maestro installation, booted simulators, app installation, optional Metro server, and writes a maestro-run-result.yaml with pass/fail counts, failure summaries, screenshots, and categorized error types.
  • Use Case: Mobile engineers in Expo, React Native, native iOS, or Flutter projects can run smoke suites, target specific flows, or analyze failures across multi-app monorepos without manual configuration.

Quick Start

Ask the assistant to run /maestro-run smoke to auto-discover the project, validate the simulator and app, and execute the smoke category flows.

Frequently Asked Questions about maestro-run

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

FAQPage Schema
How do I run Maestro end-to-end test flows on an iOS Simulator?▼

To run Maestro end-to-end test flows on an iOS Simulator, you can use an automated runner that discovers your project layout, validates the simulator and app environment, and executes the specified YAML test files.

Can I run Maestro smoke tests in a React Native or Expo monorepo?▼

Yes, you can run Maestro smoke tests in a React Native or Expo monorepo. The runner automatically discovers the closest project context by finding the .maestro, maestro, or flows directories across your workspace.

How do I execute specific Maestro YAML flows by category name?▼

To execute specific Maestro YAML flows by category name, you can invoke a command targeting the category. The runner supports flexible flow resolution including category names, exact flow files, fuzzy keyword matches, and run-all modes.

Does Maestro test automation support interactive Studio mode for debugging mobile tests?▼

Yes, Maestro test automation supports interactive Studio mode for debugging mobile tests. This allows developers to interactively debug flow failures alongside pre-flight validation and structured result generation.

How do I get structured test results and failure screenshots from Maestro test runs?▼

To get structured test results and failure screenshots from Maestro test runs, the runner writes a maestro-run-result.yaml file containing pass and fail counts, failure summaries, categorized error types, and optional screenshots.

What pre-flight checks are needed before running Maestro mobile testing flows?▼

Before running Maestro mobile testing flows, pre-flight validation must verify Maestro installation, booted iOS simulators, app installation status, and optional Metro server availability to prevent manual trial-and-error.

Related Skills

Explore More Software Engineering Skills→
DimillianDimillian
3.9k

ios-debugger-agent

Build, run, and debug iOS apps on booted simulators via XcodeBuildMCP.

Community
Advanced
mvillmowmvillmow
18

extract-test-failures

Parse test logs to extract and categorize failures by type.

Community
Basic
heaptracetechnologyheaptracetechnology
13

mobile-ci

Automate mobile CI/CD pipelines for React Native, Flutter, and native iOS/Android apps.

Community
Advanced
DishaAnandDishaAnand

mobile-app-testing

Automate mobile app testing across iOS and Android with Detox, Espresso, and XCTest.

Community
Advanced