fix

Diagnose and resolve intermittent Playwright test failures with execution traces.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/tapanshah/Claude-Skills --skill fix-tapanshah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix
Source: https://github.com/tapanshah/Claude-Skills/tree/main/engineering-team/playwright-pro/skills/fix
Command: npx skills add https://github.com/tapanshah/Claude-Skills --skill fix-tapanshah

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose and resolve issues with Playwright tests that are failing or exhibiting flaky behavior, ensuring your test suite is reliable.

Core Features & Use Cases

  • Failure Reproduction: Systematically attempts to reproduce test failures locally.
  • Trace Capture & Analysis: Generates detailed execution traces for in-depth debugging.
  • Categorization: Classifies failures into common types like Timing/Async, Test Isolation, Environment, or Infrastructure.
  • Targeted Fixes: Provides specific solutions tailored to each failure category.
  • Verification: Ensures fixes are stable by running tests multiple times.
  • Use Case: When your CI pipeline reports a test failure that you can't replicate locally, this skill will guide you through capturing the necessary data and identifying the environmental differences causing the issue.

Quick Start

Use the fix skill to debug the test file 'e2e/login.spec.ts' with the test name 'should redirect after login'.

Frequently Asked Questions about fix

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

FAQPage Schema
How do I debug flaky Playwright tests in my CI/CD pipeline?

To debug flaky Playwright tests, you systematically reproduce failures locally, capture execution traces, and categorize root causes like Timing/Async or Environment issues to apply targeted fixes and prevent recurrence.

Why does my Playwright test fail in CI but pass locally?

Playwright test failures in CI often stem from environmental differences or infrastructure issues. Capturing execution traces and categorizing root causes identifies the specific environmental disparities causing tests to pass locally but fail remotely.

What is the best way to troubleshoot Playwright timing and async errors?

The best way to troubleshoot Playwright timing and async errors is to classify them as Timing/Async failures during root cause analysis. This categorization enables applying targeted fixes and verifying stability through repeated test execution.

How do I capture execution traces for Playwright automated tests?

You capture execution traces for Playwright automated tests by reproducing the failing test scenario. This generates detailed trace data for in-depth debugging and categorizing failures into Test Isolation, Environment, or Infrastructure issues.

How can I prevent intermittent Playwright test failures from recurring?

To prevent intermittent Playwright test failures from recurring, apply targeted fixes based on categorized root causes and ensure stability by running tests multiple times. This verifies the resolution and provides recommendations to avoid future flakiness.