maestro-e2e - SKILL.md Agent Skill

name: maestro-e2e description: E2E UI testing with Maestro for iOS, Android, Flutter, React Native, and Web metadata: tags: maestro, e2e, testing, ui, automation, flutter, react-native, ios, android, web

Use this skill whenever you are:

When dealing with native permission dialogs, load the ./rules/permissions.md file for platform-specific information.

When working with Flutter apps, load the ./rules/platforms/flutter.md file for Semantics patterns.

Read individual rule files for detailed explanations and code examples:

rules/installation.md - Installing Maestro on macOS, Linux, and Windows
rules/test-structure.md - YAML test structure, appId, env variables, and flow definition
rules/commands.md - Complete reference of 40+ Maestro commands
rules/selectors.md - Element targeting with id, text, index, and matchers
rules/assertions.md - assertVisible, assertNotVisible, assertTrue, and AI assertions
rules/interactions.md - tapOn, inputText, scroll, swipe, and gesture commands
rules/permissions.md - iOS vs Android permission configuration and dialog handling

rules/platforms/android.md - Android-specific: ADB, permission dialogs, emulators
rules/platforms/ios.md - iOS-specific: auto-dismiss dialogs, simulators, limitations
rules/platforms/flutter.md - Flutter integration using Semantics and identifier
rules/platforms/react-native.md - React Native with testID and accessibilityLabel
rules/platforms/web.md - Desktop browser testing with Chromium

rules/advanced/parameters.md - Environment variables, external params, ${} syntax
rules/advanced/conditions.md - Conditional execution with when: visible, platform
rules/advanced/nested-flows.md - Reusable subflows with runFlow command
rules/advanced/javascript.md - evalScript, runScript, and GraalJS support
rules/advanced/waiting.md - extendedWaitUntil, waitForAnimationToEnd
rules/advanced/repeat-retry.md - Repeat and retry patterns for flaky tests