maestro-testing

Maestro Testing Skill

Generate production-ready Maestro YAML test flows for any mobile or web app. This skill covers flow generation, selector strategy, report generation, CI/CD integration, QA workflows, and MCP-powered AI-assisted testing.

Prerequisites & Installation

Maestro requires Java 17+ and installs with a single command — zero other dependencies:

curl -fsSL "https://get.maestro.mobile.dev" | bash

• Android: Emulator or physical device with USB debugging (API 26+)
• iOS: Xcode with iOS Simulator (macOS only, simulator builds only — no real devices)
• Web: No additional setup — Maestro auto-downloads Chromium on first run

Before Generating Flows

Read the appropriate reference file for the user's framework:

• React Native / Expo → ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/react-native.md
• Flutter → ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/flutter.md
• Native Android (Kotlin/Java/Jetpack Compose) → ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/native-android.md
• Native iOS (Swift/SwiftUI/UIKit) → ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/native-ios.md
• Hybrid (Capacitor/Ionic/Cordova/PWA) → ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/hybrid.md
• Web Desktop Browser → use url: instead of appId:, same commands. No separate reference needed.
• QA workflows, reports, CI/CD → ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/qa-workflows.md

If framework is unknown, ask. Default to ${CLAUDE_PLUGIN_ROOT}/skills/maestro-testing/references/react-native.md.

---

1. Project Structure

.maestro/
├── config.yaml                 # Workspace-level config
├── flows/
│   ├── auth/
│   │   ├── login.yaml
│   │   ├── login-invalid.yaml
│   │   ├── signup.yaml
│   │   └── logout.yaml
│   ├── onboarding/
│   │   └── first-launch.yaml
│   ├── core/
│   │   ├── create-item.yaml
│   │   ├── edit-item.yaml
│   │   └── delete-item.yaml
│   ├── navigation/
│   │   └── tab-navigation.yaml
│   ├── edge-cases/
│   │   ├── no-network.yaml
│   │   ├── empty-state.yaml
│   │   ├── orientation-change.yaml
│   │   └── long-text-input.yaml
│   └── smoke/
│       └── critical-path.yaml
├── subflows/                    # Reusable — NOT run as standalone tests
│   ├── login.yaml
│   ├── navigate-to.yaml
│   └── teardown.yaml
├── scripts/
│   ├── setup.js
│   ├── generate-data.js
│   ├── page-objects.js          # Page Object Model selectors
│   └── run-tests.sh
└── media/
    ├── test-photo.png
    └── test-video.mp4