About playwright-dev
A development guide for contributors working on the Playwright codebase. It covers architecture, API changes, MCP tools and CLI commands, dependency bundling, WebKit, version bisection, and the CLI dashboard.
Key features
- 01Codebase architecture guidance
- 02API implementation and testing guidance
- 03MCP tools and CLI development
- 04Dependency bundling instructions
- 05WebKit and dashboard development guides
Use cases
- 01Understanding Playwright library structure
- 02Adding or changing APIs with tests
- 03Developing MCP tools or CLI commands
- 04Investigating regressions across releases
MCP support
The guide includes instructions for adding MCP tools and CLI commands to Playwright.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ microsoft/ playwright --skill playwright-devAfter installing, type/playwright-devin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
api.mdbisect-published-versions.mddashboard.mdlibrary.mdtools.mdtrace_system_guide.mdvendor.mdwebkit-safari-version.mdwebview.mdDetails
From the project READMEPlaywright Development Guide
See AGENTS.md for monorepo structure, build/test/lint commands, and coding conventions.
Detailed Guides
- Library Architecture — client/server/dispatcher structure, protocol layer, DEPS rules
- Adding and Modifying APIs — define API docs, implement client/server, add tests
- MCP Tools and CLI Commands — add MCP tools, CLI commands, config options
- Vendor Dependencies & Bundling — utilsBundle, coreBundle, babelBundle; adding vendored npm packages; DEPS.list;
check_deps - Updating WebKit Safari Version — update the Safari version string in the WebKit user-agent
- WebView (iOS Safari) Backend —
webkit/webview/against stock Mobile Safari; provisional-target pause/resume; what's upstream vs Playwright patches; local + CI test setup - Bisecting Across Published Versions — reproduce regressions side-by-side from npm and diff
node_modules/playwright/lib/between versions - Dashboard - the UI powering the "playwright cli show" command, and how to work on it
Comments
Markdown supported