test-or-bug

Diagnose Playwright E2E test failures as code bugs or test issues.

30|3|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/enbyaugust/zacs-claude-skills --skill test-or-bug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-or-bug
Source: https://github.com/enbyaugust/zacs-claude-skills/tree/main/skills/test-or-bug
Command: npx skills add https://github.com/enbyaugust/zacs-claude-skills --skill test-or-bug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams determine whether an end-to-end test failure is caused by a code bug or a faulty test, accelerating debugging and remediation.

Core Features & Use Cases

  • Structured diagnosis: Runs a 5-phase workflow to classify failures as CODE BUG, TEST ISSUE, BOTH, or UNCERTAIN.
  • Guided triage: Leverages diagnostic phases, error patterns, and verdict templates to produce actionable fixes.
  • Use Case: When a Playwright E2E test fails in CI with timeout or assertion errors, this Skill guides you to identify root cause and next steps.

Quick Start

Run the diagnostic workflow on a failing Playwright test and review the generated verdict, then follow suggested fixes.

Frequently Asked Questions about test-or-bug

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

FAQPage Schema
How do I diagnose if a Playwright E2E test failure is a code bug or a test issue?

To diagnose a Playwright E2E test failure, run a structured 5-phase workflow that analyzes errors, investigates code, and checks diagnostic patterns to classify the failure as a CODE BUG, TEST ISSUE, BOTH, or UNCERTAIN.

What is the best way to triage Playwright timeout and assertion errors in CI?

The best way to triage Playwright timeout and assertion errors is to apply a guided diagnostic workflow that reviews error patterns and code changes to generate an actionable verdict and suggested fixes.

Can I use this diagnostic workflow for local Playwright test failures as well as CI environments?

Yes, you can use this diagnostic workflow for local Playwright test failures as well as CI environments, because it applies to end-to-end tests across both when tests fail, time out, or produce unexpected results.

What are the phases of the end-to-end test failure diagnostic workflow?

The phases of the end-to-end test failure diagnostic workflow are running the test, analyzing errors, investigating code, checking diagnostic patterns, and producing a final verdict to classify the failure.

Why does my Playwright test fail with unexpected results and how do I identify the root cause?

Your Playwright test may fail with unexpected results due to either a code bug or a faulty test. You identify the root cause by referencing diagnostic guidance files and checking error patterns to produce a classified verdict.