maestro-debug-test

Automate Maestro E2E test debugging by analyzing failure artifacts and device states.

1|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/luigiinred/dotfiles --skill maestro-debug-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro-debug-test
Source: https://github.com/luigiinred/dotfiles/tree/main/dot_cursor/skills/maestro-debug-test
Command: npx skills add https://github.com/luigiinred/dotfiles --skill maestro-debug-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the process of running Maestro E2E tests, diagnosing failures, and applying fixes in an iterative loop until the test passes, significantly reducing manual debugging time.

Core Features & Use Cases

  • Automated Test Execution: Runs Maestro tests with specified flags and output directories.
  • Failure Diagnosis: Analyzes screenshots, command logs, and device hierarchy to pinpoint the root cause of test failures.
  • Iterative Fixing: Applies targeted fixes to test scripts (e.g., adjusting selectors, adding waits) and re-runs tests efficiently.
  • Use Case: When a critical Maestro E2E test for a new feature fails in the CI pipeline, this Skill can automatically debug and fix it, allowing development to proceed without manual intervention.

Quick Start

Use the maestro-debug-test skill to debug the Maestro test located at 'tests/login.yml'.

Frequently Asked Questions about maestro-debug-test

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

FAQPage Schema
How do I debug and fix failing Maestro E2E tests automatically?

This Skill automates debugging and fixing failing Maestro E2E tests by analyzing failure artifacts like screenshots and command logs, diagnosing visual or hierarchical discrepancies, and iteratively applying fixes to test scripts until they pass.

How does automated test failure diagnosis work for Maestro E2E tests?

Automated test failure diagnosis works by analyzing screenshots, command logs, and device hierarchy to pinpoint the root cause of Maestro E2E test failures, applying targeted fixes like adjusting selectors or adding waits, and re-running tests efficiently.

Do I need the Maestro CLI installed to run automated E2E test debugging?

Yes, you need the Maestro CLI and device interaction tools installed in your environment, as this Skill requires Maestro CLI execution and device interaction tools to run tests, analyze device states, and apply fixes through Maestro MCP commands.

What is the best way to handle Maestro test failures in a CI/CD pipeline?

The best way to handle Maestro test failures in a CI/CD pipeline is using an automated debugging loop that executes tests with specified flags, analyzes failure artifacts, and iteratively applies targeted fixes to selectors and waits without manual intervention.

Why does my Maestro E2E test fail due to visual or hierarchical discrepancies?

Maestro E2E tests fail due to visual or hierarchical discrepancies when the device state does not match the test script expectations, requiring analysis of screenshots and device hierarchy to diagnose and apply fixes like adjusting selectors or adding waits.

Can I use this automated debugging Skill with existing Maestro test scripts?

Yes, you can use this Skill with existing Maestro test scripts by pointing it to your test file path, such as 'tests/login.yml', and it will execute the test, diagnose any failures, and apply iterative fixes to the script.