PlugWiki

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. 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. 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

  1. Activity-Based Reference Guide
  2. Writing New Tests
  3. Mobile & Responsive Testing
  4. Real-Time & Browser APIs
  5. Debugging & Troubleshooting
  6. Error & Edge Case Testing
  7. Multi-User & Collaboration Testing
  8. Architecture Decisions
  9. Framework-Specific Testing
  10. Refactoring & Maintenance
  11. Infrastructure & Configuration
  12. Advanced Patterns
  13. Quick Decision Tree
  14. 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

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
  • your project test files

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

currents-dev/playwright-best-practices-skillskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3
  1. playwright-best-practices SKILL.md · github.com
  2. playwright-best-practices-skill README · github.com
  3. javascript-testing-patterns SKILL.md · github.com

Updated Nov 2, 2026.