How does this skill help with flaky tests?

It provides a systematic approach to identify race conditions and replaces arbitrary sleep timers with condition-based waits using Playwright's auto-waiting features.

Does this skill support visual debugging tools?

Yes, it includes detailed instructions for utilizing Playwright's UI Mode, Inspector, Trace Viewer, and headed mode to visually step through execution.

Can I use this for initial script development?

While primarily focused on debugging existing failures, the diagnostic checks and selector verification patterns are highly useful for creating robust initial scripts.

What should I do if an element is found but not clickable?

The skill provides a checklist to inspect computed styles, check for overlays, scroll elements into view, and verify if the element is covered by another layer.

Playwright Debugging

Name: Playwright Debugging
Author: ed3dai

byed3dai

•

Security & Testing

Diagnoses and resolves browser automation issues like flaky tests, selector failures, and timeout errors using a systematic debugging framework.

The Playwright Debugging skill provides a structured diagnostic framework for Claude to identify and fix common browser automation failures. It guides users through reproducing issues, utilizing visual debugging tools like UI Mode and Inspector, and verifying element states to resolve flakiness and brittle selectors. This skill is essential for developers maintaining automated test suites or complex scraping scripts who need to move beyond trial-and-error fixes to build robust, reliable automation code that survives dynamic web changes and CI environments.

Key Features

0145 GitHub stars

02Remediation strategies for race conditions and complex timing issues

03Systematic diagnostic framework for reproducing and isolating automation failures

04Comprehensive checks for element visibility, actionability, and DOM state

05Guidance on converting brittle selectors to robust, accessible locators

06Integration of visual debugging tools including Playwright UI Mode and Trace Viewer

Use Cases

01Fixing flaky end-to-end tests that pass locally but fail consistently in CI environments

02Modernizing legacy scripts by replacing arbitrary timeouts with reliable condition-based waits

03Resolving 'element not found' or 'element not clickable' errors in dynamic single-page applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ed3dai/ed3d-plugins playwright-debugging

For use in Claude.ai and ChatGPT

Download Skill