# Playwright Documentation Root Cause

> Failure-analysis skill for Playwright runs. Use when Codex needs to investigate a failing test, distinguish likely product bugs from test issues, and produce a concise developer-focused root-cause report backed by evidence.

- Skill: `jovd83/playwright-documentation-root-cause` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jovd83/playwright-documentation-root-cause`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jovd83/playwright-documentation-root-cause/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: jovd83 (https://skillmd.com/u/jovd83)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jovd83/playwright-documentation-root-cause

---


# Playwright Root Cause Analysis

Use this skill when a failure needs explanation, not just rerunning.

## Inputs

- failing test output,
- trace artifacts, screenshots, videos, or HTML reports when available,
- related console, network, or application logs,
- recent code or requirement changes if they help explain the failure.

## Analysis Workflow

1. Identify the failing assertion or stopping point.
2. Reconstruct what the app and test were each expecting.
3. Classify the issue as likely `product bug`, `test defect`, `environment issue`, or `possible flake`.
4. Support the classification with concrete evidence.

## Output Contract

Provide:

- `Failure`
- `Most likely cause`
- `Classification`
- `Evidence`
- `Recommended next action`
- `Confidence`

## Guardrails

- Do not claim certainty when the evidence is mixed.
- Separate observation from hypothesis.
- If the right answer is "needs reproduction with more data," say that directly.