Skip to main content
skillsSource-backed

Playwright Trace Failure Triage Capability Pack Skill

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.

Level:expertType:capability-packVerified:validated
Review first review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Source URLs
https://playwright.dev/docs/trace-viewer-intro, https://github.com/microsoft/playwright
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.
Platform compatibility
claude-code (native-skill), codex (native-skill), windsurf (native-skill), gemini (native-skill), cursor (adapter), cli (manual-context)
Author
JSONbored
Submitted by
JSONbored
Claim status
unclaimed
Last verified
2026-06-05

Decision playbook

Review trust signals before you adopt

Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.

Compare context
Selected

0

Current score

71

Baseline

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Needs review

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done
  • Source provenance statusRequired

    Marked as source-backed.

    Done
  • Metadata reviewed

    No reviewed flag detected in metadata.

    Pending

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done
  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done
  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Needs review

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done
  • Package verification flag

    No package verification flag provided.

    Pending
  • Checksum metadata

    No checksum provided for downloaded artifact.

    Pending

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending
  • Baseline comparison available

    No baseline peer selected yet.

    Pending
  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

Package install

Copy-ready — paste the snippet to get started.

Adoption plan

Balanced adoption plan

Current risk score 24/100. Use staged verification before broader rollout.

Risk 24

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done
  • Confirm metadata review state

    No review metadata found; increase manual validation.

    Pending
  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done
  • Review privacy notesRequired

    Privacy notes are present.

    Done
  • Verify package integrity metadata

    No package verification/checksum metadata.

    Pending

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending
  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending
  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Missing required evidence: Metadata review. Risk score 31.

Risk 31

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Missing

Review metadata is missing.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Missing

Package integrity metadata is missing.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required gaps: Metadata review

Decision timeline

Decision timeline · balanced

Blocking gaps: Check metadata review status. Risk 28.

Risk 28

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is missing.

Pending

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is missing.

Pending

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

Blockers: Check metadata review status

Prerequisite readiness

Prerequisite readiness

3 prerequisites to line up before setup. Includes a review or approval gate.

0/3 ready
Configuration1Permissions & scopes1Review & approval1

Safety & privacy surface

Safety & privacy surface

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.

Schema details

Install type
package
Reading time
9 min
Troubleshooting
No
Source repository stats
Scope
Source repo
Skill and platform metadata
Skill type
capability-pack
Skill level
expert
Verification
validated
Verified at
2026-06-05
Retrieval sources
https://playwright.dev/docs/trace-viewer-introhttps://playwright.dev/docs/debughttps://playwright.dev/docs/test-configurationhttps://playwright.dev/docs/test-reportershttps://github.com/microsoft/playwright
Tested platforms
ClaudeCodexCursorWindsurfGeneric AGENTS
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.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.

Retrieval Sources

Core Workflow

  1. Identify the failed test, browser project, Playwright version, retry count, trace retention setting, and CI environment.
  2. Inventory artifacts: trace, report, screenshots, video, console output, network events, test stdout, and any attached application logs.
  3. Open the trace timeline and find the first user-visible failure, not only the final assertion message.
  4. 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.
  5. Check retries. A pass-on-retry usually needs flake classification and a deterministic reproduction attempt, not an automatic merge.
  6. Recommend the smallest fix: stable locator, fixture setup, route mock, assertion change, app bug fix, or test isolation change.
  7. 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

  1. Artifact inventory and confidence in the available evidence.
  2. Failure classification with trace-backed observations.
  3. Root cause hypothesis and alternatives ruled out.
  4. Minimal fix recommendation.
  5. Validation commands and artifact expectations.
  6. Privacy notes for anything that should not be pasted publicly.

Source citations

Add this badge to your README

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.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/skills/playwright-trace-failure-triage-capability-pack.svg)](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).

Field

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.

Open dossier

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.

Open dossier

Build resilient browser automations using Playwright MCP with robust selectors, retries, and deterministic task execution.

Open dossier

Build robust browser automation workflows for AI agents with deterministic selectors, retries, and safe action boundaries.

Open dossier
Next steps
Trust
Review statusNot reviewedNot reviewedNot reviewedNot reviewed
Package trustDiffersPackage not verifiedPackage verified2025-10-16Package verified2026-04-10Package verified2026-04-10
Source provenanceDiffersSource-backedNo submission linkNo submission linkNo submission link
SubmitterDiffersJSONbored
Install riskReview firstReview firstReview firstReview first
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
Brand
Categoryskillsskillsskillsskills
SourceSource-backedFirst-partyFirst-partyFirst-party
AuthorJSONboredJSONboredJSONboredJSONbored
Added2026-06-052025-10-162026-04-102026-04-10
Platforms
Harness
Source repo
Safety notesTrace 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 notesPlaywright 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
Install
npm init playwright@latest
npx playwright install --with-deps
curl -L https://heyclau.de/downloads/skills/playwright-mcp-browser-automation-engineer.zip -o playwright-mcp-browser-automation-engineer.zip && unzip -o playwright-mcp-browser-automation-engineer.zip -d ./playwright-mcp-browser-automation-engineer
curl -L https://heyclau.de/downloads/skills/browser-agent-workflow-automation.zip -o browser-agent-workflow-automation.zip && unzip -o browser-agent-workflow-automation.zip -d ./browser-agent-workflow-automation
Config
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed
Open 4 picks in the interactive comparison tool

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.