fix

Diagnose and resolve failing or flaky Playwright tests by categorizing issues.

2|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/zhangzhang-111-i/claude-skills111 --skill fix-zhangzhang-111-i
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix
Source: https://github.com/zhangzhang-111-i/claude-skills111/tree/main/engineering-team/playwright-pro/skills/fix
Command: npx skills add https://github.com/zhangzhang-111-i/claude-skills111 --skill fix-zhangzhang-111-i

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically diagnose and fix Playwright tests that are failing or exhibiting flaky behavior, ensuring test suite reliability.

Core Features & Use Cases

  • Failure Reproduction: Captures errors and identifies flakiness through targeted test runs.
  • Root Cause Analysis: Categorizes failures into Timing/Async, Test Isolation, Environment, or Infrastructure issues.
  • Targeted Fixes: Provides specific strategies and code examples for resolving each failure category.
  • Verification: Ensures fixes are robust by running tests multiple times.
  • Use Case: When your CI pipeline reports a test failure that passes locally, this skill guides you through identifying if it's an environment mismatch and how to resolve it.

Quick Start

Use the fix skill to resolve the intermittent failure in the test file 'e2e/login.spec.ts' for the test '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 fix flaky Playwright tests in my CI pipeline?

Fix flaky Playwright tests by categorizing failures into timing, isolation, environment, or infrastructure issues. This skill captures errors through targeted test runs and provides specific code strategies to resolve each failure category for reliable automated test suites.

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

Playwright test failures often stem from environment mismatches between local and CI infrastructure. This skill diagnoses these discrepancies by analyzing test runs and traces, identifying if the issue is an environment mismatch, and guiding you through resolving it.

How do I debug Playwright test failures using traces?

Debug Playwright test failures by executing targeted test runs via the Playwright CLI to capture errors and analyze traces. This skill performs root cause analysis on the trace output to isolate whether the failure is caused by timing or test isolation problems.

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

The best way to resolve Playwright timing errors is to categorize them as async issues and apply targeted code fixes. This skill provides specific strategies and code examples for resolving timing failures and verifies the fixes by running tests multiple times.

Do I need the Playwright CLI to debug e2e test failures?

Yes, you need the Playwright CLI installed and available to diagnose and resolve failing tests. The CLI is required to execute targeted test runs, capture errors, and analyze traces for identifying environment or infrastructure problems.

How do I verify that my Playwright test fixes resolve flakiness?

Verify Playwright test fixes by running the automated tests multiple times to ensure reliability. This skill ensures your targeted fixes are robust by executing repeated verification steps on the resolved test suite to confirm the flaky behavior is eliminated.