Playwright

This is a comprehensive rulebook for writing Playwright tests in Next.js apps, with 43 rules organized by priority from critical (test isolation, role-based selectors) to helpful (debugging config). You'd reach for this when setting up E2E tests, debugging flaky failures, or optimizing CI runs. The authentication state reuse patterns alone will save you minutes per test run. It's opinionated about avoiding XPath and hard waits, which is good because those are real footguns. The Next.js specific guidance covers hydration testing and App Router navigation, stuff that's easy to get wrong if you're coming from traditional client-side testing. Heavy on best practices, light on hand-holding, which feels right for a reference guide you'll actually consult mid-task.

skills.sh installs: 1.2K
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill playwright --agent claude-code

Installs into .claude/skills of the current project.

Files

Playwright + Next.js Testing Best Practices

Comprehensive testing optimization guide for Playwright with Next.js applications. Contains 43 rules across 8 categories, prioritized by impact to guide reliable, fast, and maintainable E2E tests.

When to Apply

Reference these guidelines when:

Writing new Playwright tests for Next.js apps
Debugging flaky or failing tests
Optimizing test execution speed
Setting up authentication state reuse
Configuring CI/CD pipelines for testing
Testing Server Components and App Router features
Reviewing test code for reliability issues

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Test Architecture	CRITICAL	`arch-`
2	Selectors & Locators	CRITICAL	`loc-`
3	Waiting & Assertions	HIGH	`wait-`
4	Authentication & State	HIGH	`auth-`
5	Mocking & Network	MEDIUM-HIGH	`mock-`
6	Next.js Integration	MEDIUM	`next-`
7	Performance & Speed	MEDIUM	`perf-`
8	Debugging & CI	LOW-MEDIUM	`debug-`