e2e-skills

e2e-skills — Playwright and Cypress E2E Test Generation, Review, and Debugging

Find Playwright and Cypress E2E tests that pass CI but prove nothing, generate new end-to-end coverage, and turn failing test reports into root-cause fixes — as Agent Skills for Claude Code, Codex, and other AGENTS.md coding agents.

E2E tests that always pass are worse than no tests — they give false confidence while real bugs slip through. e2e-skills is an AI agent testing toolkit for Playwright and Cypress: generate end-to-end tests, review existing specs for false positives and test smells, debug flaky E2E failures, and turn noisy CI reports into root-cause fixes. It runs as an Agent Skills bundle for Claude Code and Codex (and other AGENTS.md-compatible runtimes via the skills CLI) by @voidmatcha, catching what CI misses: tests that pass but prove nothing, and failures that are hard to trace.

Four complementary skills cover the full E2E testing lifecycle, from Playwright test generation to Cypress test review and failure debugging:

1. playwright-test-generator — generates Playwright E2E tests from scratch, from coverage gap analysis to passing, reviewed tests
2. e2e-reviewer — static analysis of existing Playwright and Cypress specs; flags 24 anti-patterns (P0 silent always-pass, P1 poor diagnostics, P2 maintenance) that can make tests pass CI while missing real regressions
3. playwright-debugger — diagnoses failures from playwright-report/ and classifies root causes (flaky timing, selector drift, auth, environment mismatch, and more)
4. cypress-debugger — same for Cypress report files

Contents

• Install · Workflow · Standalone scanner · Proven in OSS
• Skills: generator · reviewer · playwright-debugger · cypress-debugger
• FAQ · License

Install

# Claude Code + Codex (most common)
npx skills add voidmatcha/e2e-skills --skill '*' -g -a claude-code -a codex

# Codex plugin — via the skills CLI (Codex only)
npx skills add voidmatcha/e2e-skills --skill '*' -g -a codex

# Claude Code plugin — marketplace
/plugin marketplace add voidmatcha/e2e-skills
/plugin install e2e-skills@voidmatcha

# Claude Code plugin — manual clone
git clone https://github.com/voidmatcha/e2e-skills.git ~/.claude/skills/e2e-skills

# Every agent the skills CLI supports (55+ hosts)
npx skills add voidmatcha/e2e-skills --skill '*' -g --agent '*'

The Codex command above is the Codex plugin install: the skills CLI places the bundle in ~/.agents/skills/, where Codex auto-discovers it and reads .codex-plugin/plugin.json (the interface block). There is no separate codex plugin marketplace add step — a native marketplace entry would require duplicating the shared skills/ tree into a per-plugin subdirectory (Codex marketplace plugins cannot reference the repo root, openai/codex#17066), so the CLI route is the supported Codex path.

Quick Example

You: Review my Playwright tests in apps/viewer/src/test/

e2e-reviewer:

  [P0] settings.spec.ts:88, 99 — #4h One-shot URL read
    expect(page.url()).toEqual(`${baseURL}/${id}-public`);   // sync read, no auto-retry
    → fix: await expect(page).toHaveURL(`${baseURL}/${id}-public`);
    (also removes redundant `await page.waitForTimeout(1000)` above)

  [P0] fileUpload.spec.ts:67 — #16 Missing await on action
    page.getByRole('button', { name: 'Delete' }).click();   // fire-and-forget, races next line
    → fix: await page.getByRole('button', { name: 'Delete' }).click();

  Total: 3 P0 (2 #4h, 1 #16), 0 P1, 0 P2 in 24 spec files.
  P1/P2 candidates (not yet flagged as bugs): 20× positional .nth() selectors, 5× direct page.click(selector).

Real findings from a recent typebot.io scan — silent always-pass bugs your test suite was hiding.

Workflow