Playwright Core Skill for Claude

Battle-tested Playwright patterns for E2E, API, component, visual, accessibility, and security testing. Covers locators, assertions, fixtures, network mocking, auth flows, debugging, and framework recipes for React, Next.js, Vue, and Angular. TypeScript and JavaScript.

381k tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

4468

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/zebbern/claude-code-guide --skill playwright-core

What comes with it

1 328 176 bytes besides the instruction

accessibility.md

angular.md

api-testing.md

assertions-and-waiting.md

auth-flows.md

authentication.md

browser-apis.md

browser-extensions.md

canvas-and-webgl.md

clock-and-time-mocking.md

common-pitfalls.md

component-testing.md

configuration.md

crud-testing.md

debugging.md

drag-and-drop.md

electron-testing.md

error-and-edge-cases.md

error-index.md

file-operations.md

file-upload-download.md

fixtures-and-hooks.md

flaky-tests.md

forms-and-validation.md

i18n-and-localization.md

iframes-and-shadow-dom.md

locator-strategy.md

locators.md

mobile-and-responsive.md

multi-context-and-popups.md

multi-user-and-collaboration.md

network-mocking.md

nextjs.md

performance-testing.md

react.md

search-and-filter.md

security-testing.md

service-workers-and-pwa.md

test-architecture.md

test-data-management.md

The instruction itself

8 sections, as written by the author

Playwright Core Testing

> Opinionated, production-tested Playwright guidance — every pattern includes when (and when _not_) to use it.

46 reference guides covering the full Playwright testing surface: selectors, assertions, fixtures, network mocking, auth, visual regression, accessibility, API testing, debugging, and more — with TypeScript and JavaScript examples throughout.

Golden Rules

getByRole() over CSS/XPath — resilient to markup changes, mirrors how users see the page
Never page.waitForTimeout() — use expect(locator).toBeVisible() or page.waitForURL()
Web-first assertions — expect(locator) auto-retries; expect(await locator.textContent()) does not
Isolate every test — no shared state, no execution-order dependencies
baseURL in config — zero hardcoded URLs in tests
Retries: 2 in CI, 0 locally — surface flakiness where it matters
Traces: 'on-first-retry' — rich debugging artifacts without CI slowdown
Fixtures over globals — share state via test.extend(), not module-level variables
One behavior per test — multiple related expect() calls are fine

10. Mock external services only — never mock your own app; mock third-party APIs, payment gateways, email

Guide Index

Writing Tests

| What you're doing | Guide | Deep dive |

| -------------------------- | ------------------------------------------------------ | -------------------------------------------------- |

| Choosing selectors | locators.md | locator-strategy.md |

| Assertions & waiting | assertions-and-waiting.md | |

| Organizing test suites | test-organization.md | test-architecture.md |

| Playwright config | configuration.md | |

| Fixtures & hooks | fixtures-and-hooks.md | |

| Test data | test-data-management.md | |

| Auth & login | authentication.md | auth-flows.md |

| API testing (REST/GraphQL) | api-testing.md | |

| Visual regression | visual-regression.md | |

| Accessibility | accessibility.md | |

| Mobile & responsive | mobile-and-responsive.md | |

| Component testing | component-testing.md | |

| Network mocking | network-mocking.md | when-to-mock.md |

| Forms & validation | forms-and-validation.md | |

| File uploads/downloads | file-operations.md | file-upload-download.md |

| Error & edge cases | error-and-edge-cases.md | |

| CRUD flows | crud-testing.md | |

| Drag and drop | drag-and-drop.md | |

| Search & filter UI | search-and-filter.md | |

Debugging & Fixing

| Problem | Guide |

| -------------------------- | ---------------------------------------- |

| General debugging workflow | debugging.md |

| Specific error message | error-index.md |

| Flaky / intermittent tests | flaky-tests.md |

| Common beginner mistakes | common-pitfalls.md |

Framework Recipes

| Framework | Guide |

| ----------------------------------- | ------------------------ |

| Next.js (App Router + Pages Router) | nextjs.md |

| React (CRA, Vite) | react.md |

| Vue 3 / Nuxt | vue.md |

| Angular | angular.md |

Specialized Topics

| Topic | Guide |

| ------------------------------------------ | ------------------------------------------------------------------ |

| Multi-user & collaboration | multi-user-and-collaboration.md |

| WebSockets & real-time | websockets-and-realtime.md |

| Browser APIs (geo, clipboard, permissions) | browser-apis.md |

| iframes & Shadow DOM | iframes-and-shadow-dom.md |

| Canvas & WebGL | canvas-and-webgl.md |

| Service workers & PWA | service-workers-and-pwa.md |

| Electron apps | electron-testing.md |

| Browser extensions | browser-extensions.md |

| Security testing | security-testing.md |

| Performance & benchmarks | performance-testing.md |

| i18n & localization | i18n-and-localization.md |

| Multi-tab & popups | multi-context-and-popups.md |

| Clock & time mocking | clock-and-time-mocking.md |

| Third-party integrations | third-party-integrations.md |

Architecture Decisions

| Question | Guide |

| ------------------------ | -------------------------------------------- |

| Which locator strategy? | locator-strategy.md |

| E2E vs component vs API? | test-architecture.md |

| Mock vs real services? | when-to-mock.md |

Other skills for the same job

different authors, same section of the catalogue

Finishing A Development Branch

by ZhanlinCui

×7

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

1k tokens

Github Release Management

by ComeOnOliver

×3

Comprehensive GitHub release orchestration with AI swarm coordination for automated versioning, testing, deployment, and rollback management

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

Modern JavaScript/TypeScript development with Bun runtime. Covers package management, bundling, testing, and migration from Node.js. Use when working with Bun, optimizing JS/TS development speed, or migrating from Node.js to Bun.

8k tokens

Framework Migration Deps Upgrade

by ComeOnOliver

×2

You are a dependency management expert specializing in safe, incremental upgrades of project dependencies. Plan and execute dependency updates with minimal risk, proper testing, and clear migration pa

Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack. Use when investigating bugs, performance issues, or unexpected behavior.

6k tokens

Backend Dev Guidelines

by ComeOnOliver

×2

Opinionated backend development standards for Node.js + Express + TypeScript microservices. Covers layered architecture, BaseController pattern, dependency injection, Prisma repositories, Zod validation, unifiedConfig, Sentry error tracking, async safety, and testing discipline.

36k tokens

Javascript Typescript Jest

by github

vendor ×1

Best practices for writing JavaScript/TypeScript tests using Jest, including mocking strategies, test structure, and common patterns.

558 tokens

How to use it

Copy the folder

Take zebbern/playwright-core from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.