new-e2e-test

Scaffold Playwright E2E spec files with app-specific auth fixtures.

1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill new-e2e-test-mattbutlerengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-e2e-test
Source: https://github.com/mattbutlerengineering/mattbutlerengineering/tree/main/.claude/skills/new-e2e-test
Command: npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill new-e2e-test-mattbutlerengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of manually creating inconsistent, flaky Playwright E2E tests by providing a template that matches the repo’s existing fixtures, auth patterns, and testing conventions.

Core Features & Use Cases

  • Scaffold new E2E specs: Creates a new *.spec.ts under apps/<app>/e2e/ using the project’s house naming/patterns.
  • Correct auth strategy by app: Uses hospitality’s fixtures.js auth-gated approach (Auth0 Resource Owner Password Grant via env vars) when needed, and uses the public @playwright/test pattern for apps like marketing, gen, and rialto-web.
  • Flake-resistant test structure: Guides role-based locators, avoids CSS selector brittleness, and discourages fixed waits in favor of concrete signals.

Quick Start

Tell it the app name, the one-sentence flow description, whether the route is auth-gated, and the route path you want to exercise so it can generate a matching *.spec.ts file.

Frequently Asked Questions about new-e2e-test

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

FAQPage Schema
How do I scaffold a Playwright E2E test that matches my repo's auth fixtures?

To scaffold Playwright E2E specs matching existing auth fixtures, provide the app name, route path, flow description, and whether the route is auth-gated. The output is a TypeScript spec file using your project's role-based locators and test conventions.

How do I write flake-resistant Playwright tests for TypeScript apps?

Flake-resistant Playwright tests use role-based locators instead of brittle CSS selectors and rely on concrete signals rather than fixed waits. Scaffolding new spec files with these conventions ensures stable, consistent E2E test execution across runs.

Does this Playwright test scaffolding approach work for unauthenticated public flows?

Yes, Playwright test scaffolding supports unauthenticated public flows for apps like marketing, gen, and rialto-web by applying the standard public @playwright/test pattern instead of auth-gated fixtures.

What's the best way to structure auth-gated Playwright tests for a hospitality app?

Auth-gated Playwright tests for a hospitality app should use the repository's existing fixtures.js Auth0 Resource Owner Password Grant approach via environment variables. This ensures secure, automated authentication during E2E test execution.

Why should I avoid CSS selectors and fixed waits in Playwright E2E testing?

Avoiding CSS selectors and fixed waits in Playwright E2E testing prevents flakiness caused by DOM changes and timing issues. Using role-based locators and concrete assertion signals creates more resilient and maintainable test specs.