maestro

Automate Maestro UI flows across Android, iOS, and Web.

Updated Oct 31, 2024
One-click install
npx skills add https://github.com/thesammykins/dotfiles --skill maestro-thesammykins
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro
Source: https://github.com/thesammykins/dotfiles/tree/main/.agents/skills/maestro
Command: npx skills add https://github.com/thesammykins/dotfiles --skill maestro-thesammykins

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Maestro automation of UI flows across Android, iOS, and Web reduces manual testing effort and accelerates verification of complex flows.

Core Features & Use Cases

  • Verify Maestro docs and local environment before changes.
  • Create, refactor, and organize Maestro flow YAML files and workspace config.
  • Record flows, run tests locally or in CI, and diagnose flaky selectors and flow logic.

Quick Start

Start Maestro Studio and load or run a Maestro flow from your local workspace.

Frequently Asked Questions about maestro

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

FAQPage Schema
How do I create and organize Maestro flow YAML files for UI automation?

To create Maestro flow YAML files, you define UI automation steps using Maestro commands, organize them within a .maestro workspace, and configure workspace settings like hooks and tags to structure your test suite. This allows you to record, refactor, and run flows across platforms.

What is the best way to diagnose flaky selectors in Maestro UI tests?

Diagnosing flaky selectors in Maestro involves applying robust selector strategies, verifying flow logic, and using Maestro Studio to inspect UI elements. You can refactor your flow YAML files to target more stable element attributes, reducing test flakiness during local or CI runs.

Does Maestro support platform-specific subflows for Android, iOS, and Web?

Yes, Maestro supports platform-specific subflows allowing you to tailor UI automation for Android, iOS, and Web. You can organize your .maestro workspace to conditionally run specific flow YAML configurations and hooks based on the target platform's requirements.

How do I run Maestro UI tests locally and in CI?

You run Maestro UI tests locally by loading flows from your workspace using the Maestro CLI, and in CI by integrating the same CLI commands into your pipeline. Verifying your Maestro docs and local environment ensures consistent execution across both setups.

Why does my Maestro flow logic fail during workspace execution?

Maestro flow logic fails during workspace execution due to incorrect YAML syntax, missing workspace configuration, or flaky selectors. You can debug by verifying Maestro docs, checking hook configurations, and refactoring flow logic to ensure robust element targeting.