debugging-troubleshooting

Diagnose flaky Playwright tests using Inspector, trace viewer, and video analysis.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/AbhiRKeesara/test-automation-skills --skill debugging-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-troubleshooting
Source: https://github.com/AbhiRKeesara/test-automation-skills/tree/main/skills/debugging-troubleshooting
Command: npx skills add https://github.com/AbhiRKeesara/test-automation-skills --skill debugging-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging Playwright tests can be time-consuming and flaky. This Skill provides a structured, repeatable approach to diagnose failures using built-in Playwright tooling and a systematic troubleshooting checklist.

Core Features & Use Cases

  • Playwright Inspector guided debugging to step through tests.
  • Trace viewer and video analysis for post-mortem failure analysis.
  • Console and network debugging and a standardized troubleshooting checklist for CI or local runs.
  • Use cases: flaky tests, failing assertions, slow test repairs, CI failures with intermittent results.

Quick Start

  1. Read this Skill's guide and access the Playwright debugging sections in your tests.
  2. Follow the step-by-step routines to reproduce, isolate, and fix failures, including enabling PWDEBUG, tracing, and attaching traces or videos to reports.

Frequently Asked Questions about debugging-troubleshooting

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

FAQPage Schema
How do I debug flaky Playwright tests using the trace viewer?

Debug flaky Playwright tests by enabling tracing to capture screenshots, network requests, and DOM snapshots during execution. You can then analyze the trace viewer for post-mortem failure inspection.

What is the best way to step through failing Playwright test assertions?

The best way to step through failing Playwright assertions is using the Playwright Inspector. Enable the PWDEBUG environment variable to pause execution and inspect the DOM interactively.

Can I use Playwright built-in debugging tools for CI pipeline failures?

Yes, you can use Playwright debugging tools for CI failures by configuring trace and video recording on retry. Attach these artifacts to CI reports to analyze intermittent integration test results post-execution.

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

Playwright tests fail intermittently in CI due to network latency or timing issues. Use video analysis and a standardized troubleshooting checklist to reproduce, isolate, and fix these environment-specific failures.

Do I need external tooling to troubleshoot Playwright console and network errors?

No, you do not need external tooling to troubleshoot Playwright console and network errors. Standard Playwright usage provides built-in capabilities to capture console logs and network traffic directly within your test workflow.