Expert skill for reviewing Playwright trace artifacts, screenshots, action timelines, network events, retries, and CI evidence to classify flaky browser test failures without guessing from logs alone.
Trace artifacts can include screenshots, DOM text, URLs, request metadata, console output, and application state; review them before sharing publicly., Do not fix a trace-only symptom by adding broad waits, retries, or timeouts unless the trace evidence supports that change., Keep destructive browser actions and production-like credentials out of replayed failure reproduction.
Privacy notes
Playwright traces can expose user names, emails, tokens in URLs, internal hostnames, test data, screenshots, and API payload fragments., Public PR comments should summarize trace evidence without uploading private trace files or pasting sensitive network details.
3 safety and 2 privacy notes across 3 risk areas. Review closely: credentials & tokens, network access.
3 areas
SafetyNetwork accessTrace artifacts can include screenshots, DOM text, URLs, request metadata, console output, and application state; review them before sharing publicly.
SafetyGeneralDo not fix a trace-only symptom by adding broad waits, retries, or timeouts unless the trace evidence supports that change.
SafetyCredentials & tokensKeep destructive browser actions and production-like credentials out of replayed failure reproduction.
PrivacyCredentials & tokensPlaywright traces can expose user names, emails, tokens in URLs, internal hostnames, test data, screenshots, and API payload fragments.
PrivacyNetwork accessPublic PR comments should summarize trace evidence without uploading private trace files or pasting sensitive network details.
Safety notes
Trace artifacts can include screenshots, DOM text, URLs, request metadata, console output, and application state; review them before sharing publicly.
Do not fix a trace-only symptom by adding broad waits, retries, or timeouts unless the trace evidence supports that change.
Keep destructive browser actions and production-like credentials out of replayed failure reproduction.
Privacy notes
Playwright traces can expose user names, emails, tokens in URLs, internal hostnames, test data, screenshots, and API payload fragments.
Public PR comments should summarize trace evidence without uploading private trace files or pasting sensitive network details.
Prerequisites
Playwright test failure, trace artifact, test report, or CI run under review.
Access to test source, Playwright config, browser/project name, retry settings, and relevant artifacts.
Permission to inspect screenshots, DOM snapshots, console logs, network events, and request/response metadata.
.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursor
Adapter
.cursor/rules/<skill-name>.mdc
cli
Manual
AGENTS.md or tool-specific context file
Full copyable content
# Trigger
"Apply the Playwright trace failure triage capability pack to this failed test."
# Required output
1) Artifact inventory and Playwright version evidence
2) Failure classification from trace actions, DOM snapshots, network, console, and retries
3) Root-cause hypothesis with supporting trace evidence
4) Smallest safe fix and regression validation plan
About this resource
Knowledge Freshness
This capability pack is grounded in the current Playwright Trace Viewer,
debugging, test configuration, and reporter documentation checked on
2026-06-05. Prefer the official Playwright docs and repository over remembered
behavior when reviewing trace retention, report fields, or CLI commands.
Identify the failed test, browser project, Playwright version, retry count,
trace retention setting, and CI environment.
Inventory artifacts: trace, report, screenshots, video, console output,
network events, test stdout, and any attached application logs.
Open the trace timeline and find the first user-visible failure, not only the
final assertion message.
Compare action snapshots before and after the failing step. Classify whether
the failure is locator ambiguity, timing, navigation, network, auth, data,
accessibility role mismatch, animation, browser-specific behavior, or product
regression.
Check retries. A pass-on-retry usually needs flake classification and a
deterministic reproduction attempt, not an automatic merge.
Recommend the smallest fix: stable locator, fixture setup, route mock,
assertion change, app bug fix, or test isolation change.
Provide a validation plan with the exact Playwright command, browser project,
retry setting, and artifact retention expected after the fix.
Capability Scope
Trace viewer evidence review
Timeline/action classification
DOM snapshot and screenshot comparison
Console and network event triage
Retry and CI artifact interpretation
Locator, assertion, fixture, and isolation recommendations
Privacy-safe public summary of trace evidence
Compatibility
Native
Claude Code and Claude: use as a reusable skill for Playwright failure review.
Codex workflows: use for PR review and CI failure triage where artifacts are available.
Manual Adaptation
Generic AGENTS files: convert the workflow into a browser-test failure review checklist.
Cursor and Windsurf: use the output contract when reviewing trace artifacts from CI.
Required Inputs
Failed test name, file, browser project, and retry number
Playwright config and trace retention setting
Trace artifact or report link
Relevant test source and fixture setup
Expected product behavior and environment details
Production Rules
Do not approve a change only because the test passed on retry.
Do not suggest arbitrary waits without trace evidence that the application was still legitimately loading.
Do not expose screenshots, URLs, request payloads, or DOM text from private traces in public comments.
Prefer role-based or user-visible locator fixes when the trace shows selector brittleness.
Keep app regressions separate from test bugs; a failing trace can prove the product is wrong.
Require a rerun of the affected browser project after the fix.
Output Contract
Artifact inventory and confidence in the available evidence.
Failure classification with trace-backed observations.
Root cause hypothesis and alternatives ruled out.
Minimal fix recommendation.
Validation commands and artifact expectations.
Privacy notes for anything that should not be pasted publicly.
Show that Playwright Trace Failure Triage Capability Pack Skill is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.
[](https://heyclau.de/entry/skills/playwright-trace-failure-triage-capability-pack)
How it compares
Playwright Trace Failure Triage Capability Pack Skill side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.
3 trust signals differ across this comparison (Package trust, Source provenance, Submitter).
Expert skill for reviewing Playwright trace artifacts, screenshots, action timelines, network events, retries, and CI evidence to classify flaky browser test failures without guessing from logs alone.
Write and maintain reliable end-to-end tests with Playwright — Microsoft's browser automation library that auto-waits for actionable elements and runs the same suite against Chromium, Firefox, and WebKit.
✓Trace artifacts can include screenshots, DOM text, URLs, request metadata, console output, and application state; review them before sharing publicly.
Do not fix a trace-only symptom by adding broad waits, retries, or timeouts unless the trace evidence supports that change.
Keep destructive browser actions and production-like credentials out of replayed failure reproduction.
✓`npx playwright install --with-deps` downloads browser binaries (~500 MB for Chromium, Firefox, and WebKit) from Playwright's CDN and on Linux installs system-level packages. Review your network and environment policies before running in restricted infrastructure.
Generated tests have full browser-level access to any URL they target. Review test scripts before running them against authenticated sessions or production environments — Playwright can submit forms, click buttons, and make network requests as a real user.
✓Can design automation for live browsers, accounts, workflows, or infrastructure; use staging targets and human approval before destructive or account-write actions.
Keep API tokens and service credentials least-privileged, and verify generated runbooks before scheduling or unattended execution.
✓Can design automation for live browsers, accounts, workflows, or infrastructure; use staging targets and human approval before destructive or account-write actions.
Keep API tokens and service credentials least-privileged, and verify generated runbooks before scheduling or unattended execution.
Privacy notes
✓Playwright traces can expose user names, emails, tokens in URLs, internal hostnames, test data, screenshots, and API payload fragments.
Public PR comments should summarize trace evidence without uploading private trace files or pasting sensitive network details.
✓Playwright runs entirely on your local machine. Traces, screenshots, and HTML test reports are written to local disk only and are not uploaded to Microsoft or any external service.
Trace files and failure screenshots may capture sensitive content from the application under test (form data, rendered PII, session tokens visible in URLs). Store and rotate these files appropriately.
✓Inputs and outputs can include browser state, account metadata, workflow payloads, infrastructure inventory, logs, and operational screenshots.
Redact credentials, session data, customer records, internal hostnames, and private workspace details before sharing prompts or artifacts.
✓Inputs and outputs can include browser state, account metadata, workflow payloads, infrastructure inventory, logs, and operational screenshots.
Redact credentials, session data, customer records, internal hostnames, and private workspace details before sharing prompts or artifacts.
Prerequisites
Playwright test failure, trace artifact, test report, or CI run under review.
Access to test source, Playwright config, browser/project name, retry settings, and relevant artifacts.
Permission to inspect screenshots, DOM snapshots, console logs, network events, and request/response metadata.
Node.js 18+
Playwright 1.40+ with the @playwright/test package
Browser binaries installed via `npx playwright install` (Chromium, Firefox, WebKit)
A web application accessible for testing (local dev server, staging, or production URL)
Browser automation target URL(s)
Playwright MCP server configured in your agent environment
Test credentials with least required permissions
Target web workflow with clear start and success states
Ability to run browser automation in local or CI environment
Access to auth/session strategy if login is required