Playwright Best Practices Skill from Currents for Claude Code
playwright-best-practices (by currents.dev) gives Claude a library of Playwright testing guides, and points it to the right one for the job.
- Installs
- 101.3K
- on skills.sh
- Stars
- 414
- on GitHub
- Files
- 58
- besides SKILL.md
- Updated
- Jul 2026
- last repo commit
The skill loads when you ask for help with Playwright tests. SKILL.md is an index. It maps each activity, such as writing E2E tests, fixing flaky tests or setting up CI, to the reference files that cover it, so Claude reads only what it needs.
Behind the index are 58 guides in 8 folders: core, advanced, architecture, browser APIs, debugging, frameworks (React, Angular, Vue, Next.js), CI/CD and testing patterns. After writing tests, SKILL.md tells Claude to run npx playwright test --reporter=list, fix failures, and repeat critical tests with --repeat-each=5.
It bundles no scripts, and the README only says to run npx skills add to install it. Currents sells a Playwright dashboard, so a few guides may mention its products.
Good for
- Developers writing Playwright tests in TypeScript with Claude
- QA engineers fixing flaky tests and failing CI runs
- Teams setting up Playwright CI, sharding, Docker or reporting
- Anyone testing accessibility, mobile layouts, Electron apps or browser extensions
Install playwright-best-practices
Claude Code
- 1
Copy this prompt.
Install the playwright-best-practices skill in Claude Code. Run this command: npx skills add https://github.com/currents-dev/playwright-best-practices-skill --skill playwright-best-practices Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
From its listing on skills.sh. Source.
What's in the skill
When it loads
Use when writing Playwright tests, fixing flaky tests, debugging failures, implementing Page Object Model, configuring CI/CD, optimizing performance, mocking APIs, handling authentication or OAuth, testing accessibility (axe-core), file uploads/downloads, date/time mocking, WebSockets, geolocation, permissions, multi-tab/popup flows, mobile/responsive layouts, touch gestures, GraphQL, error handling, offline mode, multi-user collaboration, third-party services (payments, email verification), console error monitoring, global setup/teardown, test annotations (skip, fixme, slow), test tags (@smoke, @fast, @critical, filtering with --grep), project dependencies, security testing (XSS, CSRF, auth), performance budgets (Web Vitals, Lighthouse), iframes, component testing, canvas/WebGL, service workers/PWA, test coverage, i18n/localization, Electron apps, or browser extension testing. Covers E2E, component, API, visual, accessibility, security, Electron, and extension testing.
Sections in SKILL.md
- Activity-Based Reference Guide
- Writing New Tests
- Mobile & Responsive Testing
- Real-Time & Browser APIs
- Debugging & Troubleshooting
- Error & Edge Case Testing
- Multi-User & Collaboration Testing
- Architecture Decisions
- Framework-Specific Testing
- Refactoring & Maintenance
- Infrastructure & Configuration
- Advanced Patterns
- Quick Decision Tree
- Test Validation Loop
Key facts
- Installs on skills.sh
- 101,324 as of 2026-11-02
- GitHub stars (whole repo)
- 414 as of 2026-11-02
- License
- MIT
- Last repo commit
- 2026-07-21
- Files in the skill folder
- 59 files including SKILL.md
- skills.sh audits
- Gen Agent Trust Hub pass, Socket pass, Snyk pass
What it includes
Test structure, locators, waiting, fixtures, config, tags
Guides for the basics: suite structure, locators, assertions and waiting, fixtures and hooks, page objects, test data, global setup, projects and tags.
core/Flaky tests, debugging, console errors, error states
Where Claude looks when a test fails or flakes, including trace viewer use.
debugging/Auth, mobile, multi-user, clock mocking, network
Guides for authentication flows, mobile and touch emulation, multi-tab and multi-user tests, date and time mocking, third-party services.
advanced/GitHub Actions, GitLab, Docker, sharding, reporting
CI setup guides, performance, parallel sharding and coverage.
infrastructure-ci-cd/Accessibility, API, visual, security, Electron, extensions
Guides per kind of test, from forms and drag-and-drop to canvas/WebGL and file upload.
testing-patterns/React, Angular, Vue, Next.js, iframes, WebSockets
Framework-specific advice and guides for browser features like service workers.
frameworks/ and browser-apis/Page objects vs fixtures, test types, when to mock
Decision guides for how to structure a test suite.
architecture/Run npx playwright test, fix, then repeat critical tests
After changing tests, Claude runs the suite with the list reporter, inspects traces with npx playwright show-trace, and reruns critical tests with --repeat-each=5.
Runs code ·
Test validation loop
From the official docs
Permissions
Low risk
The skill itself is markdown only, but it tells Claude to run Playwright through npx in your project and its guides contain CI, Docker and install commands. Review commands before you approve them.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It asks Claude to run your test suite
SKILL.md tells Claude to run npx playwright test after changes, and to repeat critical tests. Tests can hit real services, so point them at a test environment. github.com
Guides include install and CI commands
Reference files such as docker.md show npm ci and npx playwright test inside Docker commands. Check commands in the guides before running them in your own setup. github.com
Technical details
| Scopes |
|
|---|
Questions
What does the Playwright best practices skill do?
It guides Claude through Playwright testing in TypeScript. SKILL.md maps your task, such as writing tests, fixing flaky tests or setting up CI, to one of the reference guides. The skill folder holds 58 guides plus SKILL.md (59 files, counted from the repo tree). The README's own heading says 57 reference documents, so it is one behind the folder.
How do I install it in Claude Code?
Use the install box above. The README documents one command, npx skills add with the repo URL. It does not describe a Claude app upload or Codex setup.
Do I have to say "Playwright best practices" to trigger it?
No. The README says you can describe the task, for example "fix this flaky login test", and the assistant uses the skill when it is relevant.
Does it need an API key or a paid Currents account?
The skill names no key and bundles no scripts. It is published by currents.dev, whose dashboard is a separate product that the README mentions.
Is it safe to install?
It is a set of markdown guides with no bundled scripts. It does tell Claude to run npx playwright test in your project, so review commands before approving them, and note that some guides show Docker and CI setup commands.
How is it different from javascript-testing-patterns?
This one is only about Playwright and browser tests. The javascript-testing-patterns skill covers Jest, Vitest and Testing Library unit and component tests.
Information
updated Nov 2, 2026
- Folder
playwright-best-practices
Sources
Docs, issue trackers and discussions this page is built from.
Show all 3Hide
- playwright-best-practices SKILL.md · github.com
- playwright-best-practices-skill README · github.com
- javascript-testing-patterns SKILL.md · github.com