qa-test-healer

Analyze failing Playwright and Cypress tests and apply targeted fixes.

2|2|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/AZANIR/qa-skills --skill qa-test-healer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-test-healer
Source: https://github.com/AZANIR/qa-skills/tree/main/.cursor/skills/qa-test-healer
Command: npx skills add https://github.com/AZANIR/qa-skills --skill qa-test-healer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automatically fixes broken automated tests after code changes, reducing manual debugging time and ensuring test suite stability.

Core Features & Use Cases

  • Automated Failure Analysis: Identifies the root cause of test failures (e.g., broken selectors, assertion changes).
  • Targeted Self-Healing: Applies specific fixes like updating locators, adjusting assertions, or modifying waits.
  • Marking Unfixable Tests: Clearly flags tests that cannot be automatically resolved with an explanation.
  • Use Case: After a UI refactor, your Playwright tests start failing due to changed element selectors. This Skill automatically finds the new selectors and updates the tests, or marks them if the fix is too complex for automation.

Quick Start

Use the qa-test-healer skill to fix the failing tests in the provided file path.

Frequently Asked Questions about qa-test-healer

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

FAQPage Schema
How do I auto-fix failing Playwright tests after a UI refactor?

You can auto-fix failing Playwright tests by providing the file path to qa-test-healer, which analyzes failures, applies targeted fixes to broken locators and assertions, and flags unfixable tests with explanations.

What is self-healing test automation and how does it work for Cypress?

Self-healing test automation automatically fixes broken Cypress tests by analyzing failures, applying targeted fixes to selectors, assertions, and waits, and marking unfixable tests with explanations to reduce manual debugging time.

Can I use automated test healing for both Playwright and Cypress frameworks?

Yes, automated test healing supports both Playwright and Cypress frameworks, integrating with MCP tools for DOM inspection and debugging to apply targeted fixes or mark unfixable tests with explanations.

How do I update broken selectors in my test suite automatically?

To update broken selectors automatically, qa-test-healer analyzes test failures, identifies root causes like changed element selectors, and applies targeted fixes to locators, assertions, and waits to restore test suite stability.

What happens to tests that cannot be automatically fixed by self-healing?

Tests that cannot be automatically fixed are clearly marked as unfixable with detailed explanations, ensuring developers know exactly which tests require manual debugging and why the automated fix was not applied.

How do I debug failing test assertions and waits after code changes?

To debug failing test assertions and waits after code changes, qa-test-healer analyzes the root cause of failures and applies targeted fixes to assertions and waits, integrating with MCP tools for DOM inspection.