Agent skill

Debug E2E Test

by bitovi in bitovi/ai-enablement-prompts

Debug and fix failing Playwright E2E tests. An agent skill from bitovi/ai-enablement-prompts.

MITAuto-check passedTesting & QA

Install Debug E2E Test

skills CLI
$ npx skills add bitovi/ai-enablement-prompts --skill debug-e2e-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bitovi/ai-enablement-prompts debug-e2e-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bitovi/ai-enablement-prompts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/playwright/skills/debug-e2e-test .claude/skills/debug-e2e-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debug-e2e-test
GitHub stars
121
Token cost
~677 tokens
SKILL.md length
323 words
Files
1
Skills in repo
40
Repo updated
First seen
Licence
MIT

At a glance

Debug and fix failing Playwright E2E tests. An agent skill from bitovi/ai-enablement-prompts.

  • Works in 9 steps: Run the Specific Failed Test → Analyze the Test Output → Load the Screenshot → …
  • Asked to fix failing tests
  • SKILL.md covers When to Use, Debugging Workflow, Intermittent Failures —… and Tips
  • Calls npx

What it does

Debug E2E Test is an agent skill from bitovi/ai-enablement-prompts. Debug and fix failing Playwright E2E tests. Use when tests fail, when asked to fix failing tests, or when investigating test failures. Analyzes test output, screenshots, error context, and uses Playwright MCP to identify root causes.

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering End-to-end testing, Failing and flaky tests and Browser testing. It works with Playwright and Model Context Protocol. The repository describes itself as: Prompts Bitovi uses for software development. The licence is MIT.

When your agent uses it

  • Asked to fix failing tests
  • Investigating test failures

Example prompts

  • “/debug-e2e-test”

Requirements

  • Node.js

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Run the Specific Failed Test
  2. Analyze the Test Output
  3. Load the Screenshot
  4. Read the Error Context
  5. Read the Test Code
  6. Compare Test Expectations with Implementation
  7. Use Playwright MCP (If Needed)
  8. Fix the Issue
  9. Verify the Fix

What it can do on your machine

Read from SKILL.md and the folder at commit df229b1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debug E2E Test loads about 677 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 323 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~677

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bitovi/ai-enablement-prompts at commit df229b1, republished under its MIT licence (© bitovi). 323 words, ~677 tokens.

Download SKILL.mdSave it as .claude/skills/debug-e2e-test/SKILL.md (or your agent's skills folder).
name
debug-e2e-test
description
Debug and fix failing Playwright E2E tests. Use when tests fail, when asked to fix failing tests, or when investigating test failures. Analyzes test output, screenshots, error context, and uses Playwright MCP to identify root causes.

Skill: Debug E2E Test

Systematic workflow for debugging and fixing failing Playwright E2E tests.

When to Use

  • A Playwright E2E test is failing
  • Asked to fix a failing test
  • Investigating why tests are broken
  • Tests pass locally but fail in CI

Debugging Workflow

Step 1: Run the Specific Failed Test

Run ONLY the specific failing test:

bash
npx playwright test <test-file>.spec.ts -g "test name"
Step 2: Analyze the Test Output

Extract from terminal output:

  1. Test location: File path and line number
  2. Failure type: What assertion failed
  3. Expected vs Actual: What the test expected vs what it got
  4. Error message: The specific error
  5. Artifact paths: Screenshot and error-context locations
Step 3: Load the Screenshot

Use the screenshot from test results to see the visual state at failure time.

Step 4: Read the Error Context

Read any error-context.md file from test results:

  • DOM snapshot
  • Console logs
  • Network errors
Step 5: Read the Test Code

Understand what the test is trying to do, what selectors it uses, and what assertions it makes.

Step 6: Compare Test Expectations with Implementation
bash
grep -r "text the test looks for" src/ --include="*.tsx"

Check: routes, text content, element types, selectors.

Step 7: Use Playwright MCP (If Needed)

If artifacts don't reveal the issue:

  1. Navigate to the page
  2. Take a screenshot
  3. Get visible HTML
  4. Interact with elements
  5. Inspect behavior
Step 8: Fix the Issue

Fix the test, the code, or both.

Step 9: Verify the Fix
bash
npx playwright test <test-file>.spec.ts -g "test name"

Intermittent Failures — Non-Deterministic Data

If tests pass sometimes and fail other times:

Common Causes
  1. Sample generators using Date.now() or new Date()
  2. Missing seeds in mock handlers
  3. Stories without seeds
How to Diagnose
bash
npx playwright test <file>.spec.ts -g "test name"
npx playwright test <file>.spec.ts -g "test name"
# If results differ, you have non-deterministic data
How to Fix
  1. Update sample generators to use seeds
  2. Add seeds everywhere — never call sample functions without seeds

Tips

  1. Always run the single test first
  2. Start with artifacts — screenshot + error-context tell you 90% of issues
  3. Use MCP sparingly
  4. Check obvious things first — routes, text, element types
  5. One test at a time

© bitovi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/playwright/skills/debug-e2e-test of bitovi/ai-enablement-prompts.

Open the folder on GitHubat commit df229b1

Compare with similar skills

Debug E2E Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debug E2E Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug E2E Test this skillbitovi/ai-enablement-prompts121—~677Automated safety check: PassMIT
Debugging Opik E2E Testscomet-ml/opik22k—~1.8kAutomated safety check: PassApache-2.0
Playwright Testingchongdashu/vibejam-starter-pack149—~2.2kAutomated safety check: PassNone
E2Esendou-ink/sendou.ink297—~2.1kAutomated safety check: NotesAGPL-3.0
Playwright Healing AgentTahanima/playwright-java-test-automation-architecture113—~210Automated safety check: PassMIT
Activitypub TestingMicrock/ordinary-claude-skills401—~712Automated safety check: PassCustom licence

Similar skills

  • Investigates a failed Opik end-to-end test from CI, TestOps or a local run, decides regression versus flake, and proposes a fix without editing tests.

    22k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Playwright Testing

    chongdashu/vibejam-starter-pack

    Plan, implement, and debug frontend tests: unit/integration/E2E/visual/a11y.

    149 GitHub stars~2.2k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • E2E

    sendou-ink/sendou.ink

    Run, debug, and manage Playwright e2e tests. An agent skill from sendou-ink/sendou.ink.

    297 GitHub stars~2.1k tokensUpdated today
    Testing & QAAuto-check: notes
  • Playwright Healing Agent

    Tahanima/playwright-java-test-automation-architecture

    Expert in diagnosing Playwright failures. Uses the @playwright MCP to verify live DOM state.

    113 GitHub stars~210 tokensUpdated 7 mo ago
    Testing & QAAuto-check passed
  • Activitypub Testing

    Microck/ordinary-claude-skills

    Testing patterns for PHPUnit and Playwright E2E tests. An agent skill from Microck/ordinary-claude-skills.

    401 GitHub stars~712 tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Playwright

    pproenca/dot-skills

    Playwright testing best practices for Next.js applications (formerly test-playwright).

    214 GitHub stars~1.7k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

More from bitovi/ai-enablement-prompts

All 40 skills in this repo
  • Component Registry

    bitovi/ai-enablement-prompts

    Track reusable UI components and unextracted patterns. An agent skill from bitovi/ai-enablement-prompts.

    121 GitHub stars~597 tokensUpdated 26 days ago
    Auto-check passed
  • Computed Styles

    bitovi/ai-enablement-prompts

    Extract and compare computed CSS styles between a baseline URL and a dev/Storybook URL using Playwright MCP evaluate calls.

    121 GitHub stars~2.4k tokensUpdated 26 days ago
    Auto-check passed
  • Create Plugin

    bitovi/ai-enablement-prompts

    A skill your agent uses when the user asks to "create a plugin", "add a plugin", "make a new plugin", "build a plugin", or wants to package skills into an installable plugin for this marketplace.

    121 GitHub stars~2k tokensUpdated 26 days ago
    Auto-check passed
  • Create React Modlet

    bitovi/ai-enablement-prompts

    Create React components, hooks, or utilities following the modlet pattern.

    121 GitHub stars~2.1k tokensUpdated 26 days ago
    Auto-check passed
  • Create Skill

    bitovi/ai-enablement-prompts

    A skill your agent uses when the user asks to "create a skill", "add a skill", "make a new skill", "build a skill", or wants to automate a repeated workflow into a reusable prompt.

    121 GitHub stars~1.6k tokensUpdated 26 days ago
    Auto-check passed
  • Create Skill

    bitovi/ai-enablement-prompts

    Create new Agent Skills for this project. An agent skill from bitovi/ai-enablement-prompts.

    121 GitHub stars~1.7k tokensUpdated 26 days ago
    Auto-check passed

Categories

Questions about Debug E2E Test

What does Debug E2E Test do?

Debug and fix failing Playwright E2E tests. An agent skill from bitovi/ai-enablement-prompts. Debug E2E Test is an agent skill from bitovi/ai-enablement-prompts. Debug and fix failing Playwright E2E tests.

When should I use Debug E2E Test?

Debug E2E Test fits situations like: asked to fix failing tests; investigating test failures.

How do I install Debug E2E Test in Claude Code?

Run `npx skills add bitovi/ai-enablement-prompts --skill debug-e2e-test -a claude-code`. Or copy the skill folder (plugins/playwright/skills/debug-e2e-test in bitovi/ai-enablement-prompts) into .claude/skills/debug-e2e-test in your project. Claude Code loads it when a task matches its description.

How do I install Debug E2E Test in Codex?

Run `npx skills add bitovi/ai-enablement-prompts --skill debug-e2e-test -a codex`. Or copy the skill folder (plugins/playwright/skills/debug-e2e-test in bitovi/ai-enablement-prompts) into .agents/skills/debug-e2e-test in your project. Codex loads it when a task matches its description.

Can I use Debug E2E Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitovi/ai-enablement-prompts --skill debug-e2e-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debug-e2e-test, .gemini/skills/debug-e2e-test, .github/skills/debug-e2e-test and .opencode/skills/debug-e2e-test in your project.

What does Debug E2E Test need to run?

Going by SKILL.md and its folder, Debug E2E Test needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Debug E2E Test access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Debug E2E Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Debug E2E Test use?

Debug E2E Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debug E2E Test use?

About 677 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Debug E2E Test?

Skills that share tags, products or a category with Debug E2E Test: Debugging Opik E2E Tests (comet-ml/opik, 22k stars), Playwright Testing (chongdashu/vibejam-starter-pack, 149 stars), E2E (sendou-ink/sendou.ink, 297 stars) and Playwright Healing Agent (Tahanima/playwright-java-test-automation-architecture, 113 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug E2E Test?

bitovi (a GitHub organization) maintains it in bitovi/ai-enablement-prompts, which has 121 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on September 11, 2026.

Source: bitovi/ai-enablement-prompts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.