fix-flaky-tests

Diagnose and fix flaky Playwright tests through root-cause analysis.

4|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/lespaceman/athena-workflow-marketplace --skill fix-flaky-tests-lespaceman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-flaky-tests
Source: https://github.com/lespaceman/athena-workflow-marketplace/tree/main/plugins/playwright-automation/skills/fix-flaky-tests
Command: npx skills add https://github.com/lespaceman/athena-workflow-marketplace --skill fix-flaky-tests-lespaceman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematically diagnose and fix intermittent Playwright test failures using root cause analysis. A flaky test is worse than no test — it trains teams to ignore failures.

Core Features & Use Cases

  • Reproduce and classify flaky tests by running a few iterations to observe patterns.
  • Identify root cause categories (timing, state leakage, race conditions, selector fragility, environment, evidence gaps) and apply targeted fixes.
  • Verify stability with repeat runs and guardrails to prevent recurrence.

Quick Start

Provide the test file path or name to begin diagnosing flakiness for a Playwright test.

Frequently Asked Questions about fix-flaky-tests

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

FAQPage Schema
How do I fix flaky Playwright tests in my automation suite?

Fix flaky Playwright tests by performing root-cause analysis through structured workflows that reproduce failures, classify root causes like timing or state leakage, and apply targeted fixes with verification steps to ensure test stability.

What causes intermittent Playwright test failures during repeat runs?

Intermittent Playwright test failures are caused by timing issues, state leakage, race conditions, selector fragility, environment inconsistencies, or evidence gaps. Identifying the specific category through pattern observation allows applying the correct targeted fix.

How do I diagnose the root cause of a flaky test?

Diagnose flaky test root causes by running a few iterations to observe failure patterns, then classifying the behavior into categories like race conditions or selector fragility to determine the appropriate evidence-backed remediation.

Can I use this structured workflow to fix flaky tests for any automation testing framework?

The workflow is specifically designed for Playwright test stability. It enforces safe practices with evidence-backed methods and a remediation checklist tailored to diagnosing and fixing intermittent failures within the Playwright automation testing framework.

What's the best way to prevent flaky tests from recurring after a fix?

Prevent flaky tests from recurring by applying a remediation checklist and verifying stability with repeat runs. Guardrails ensure the targeted fixes hold over time and maintain long-term test stability against race conditions and state leakage.