Inside the Microsoft Playwright Plugin for Claude Code
By Flowy · Updated 2026-08-28
The microsoft/playwright plugin packages Claude Code agents and skills taken directly from Playwright's own GitHub repository. Three prompt and agent pairs plan, generate, and fix browser tests, and a fourth prompt reports test coverage. Seven skills cover everyday Playwright testing, trace inspection, CI result queries, bug triage, and the project's own development and release work.
What is the microsoft/playwright plugin, actually
Playwright is Microsoft's own framework for web testing and automation, built to run one API against Chromium, Firefox, and WebKit. microsoft/playwright is the Claude Code plugin published straight from that project's own GitHub repository (95,114 stars, by Flowy's own count), not a wrapper someone else built around it. Flowy indexes the repository the way it indexes every crawled plugin: it reads the manifest and lists what actually ships inside; it does not own, bundle, or host the code. Flowy files this listing under the Testing category.
The plugin ships 14 components in total: 7 agents and 7 skills. Read together, they split into three groups: prompts and agents that plan, generate, and fix tests for you; skills for everyday Playwright work such as the CLI and component testing; and skills built for people who work on the Playwright project itself. Install it from the listing page linked at the top of this guide, since that page generates the current install command rather than a copy that can drift out of date.
Which agents plan, generate, and fix tests
Six of these agents form three matched pairs: a prompt file and an agent file that do the same job. playwright-test-plan.prompt creates a test plan, and playwright-test-planner.agent is described as the one to use when you need a complete test plan for a web application or website. Use either when you are starting from a page or a feature and need to decide what to test before writing an assertion.
playwright-test-generate.prompt and playwright-test-generator.agent sit on the generation side. The prompt generates a test plan; the agent is described as the one to use when you need to create automated browser tests using Playwright.
playwright-test-heal.prompt and playwright-test-healer.agent fix tests. The agent is described as the one to use when you need to debug and fix failing Playwright tests, the failure mode that shows up whenever a selector or a flow changes.
The seventh, playwright-test-coverage.prompt, has no matching agent file. It produces test coverage, for a reader who wants to know how much of an application a Playwright suite already reaches.
Which skills cover everyday Playwright work
playwright-cli is the general-purpose one: it automates browser interactions, tests web pages, and works with existing Playwright tests. It is the skill most people reach for first.
playwright-component-testing is scoped to a single component rather than a whole page. It sets up component testing with Playwright using a story gallery, scaffolding stories and a gallery dev page driven by Playwright's built-in mount fixture instead of a separate component-testing runtime. Its own description points to testing React or Vue components in isolation, and to moving off another component-testing setup.
Which skills help once something has already gone wrong
playwright-trace inspects Playwright trace files from the command line: actions, requests, console output, errors, snapshots, and screenshots.
playwright-test-results queries Playwright CI test results from an aggregated DuckDB database, answering questions about flaky tests, failure rates, and slow tests, or the results for one run, one commit, or one pull request, without hunting through GitHub artifacts by hand.
playwright-triage reproduces a bug report from the information already in a GitHub issue, whether the issue is new or just picked up another comment.
Which skills are for people building Playwright itself
Two skills are aimed at Playwright's own maintainers rather than at a team testing its own application. playwright-devops covers CI failure analysis, workflow debugging, and release operations for the project. playwright-dev explains how to develop Playwright itself: how to add APIs, MCP tools, CLI commands, and vendor dependencies. Neither does much for you unless you are working inside the Playwright codebase.
Is this plugin for testing an app, or for working on Playwright itself
Both, and the plugin draws a clean line between the two. Most of it, the test planning, generating, and healing agents, plus playwright-cli, playwright-component-testing, playwright-trace, playwright-test-results, and playwright-triage, is for any team that already tests with Playwright and wants Claude Code inside that loop. playwright-devops and playwright-dev are for contributors to the Playwright project itself. If you only test your own application, the first group is the reason to install this plugin, and the other two skills will sit unused.
How do I install it
Flowy indexes microsoft/playwright from its public GitHub repository; it does not host or bundle these components. Install from the listing page linked at the top of this guide rather than from a command written into this text, since the listing page is what stays current. Once installed, match the group above to what you are actually trying to do: most readers only need the everyday testing skills and the test generation and healing agents, not the maintainer tooling.
Common questions
- What does the microsoft/playwright Claude Code plugin actually do?
- It packages Claude Code agents and skills taken straight from Playwright's own GitHub repository, not a separate testing tool. The plugin ships 14 components in total: 7 agents that plan, generate, and fix Playwright tests, and 7 skills covering everyday Playwright work, CI result queries, trace inspection, and bug triage. Install it from the plugin's listing page on Flowy, since that page generates the current install command.
- What is the difference between playwright-test-generate.prompt and playwright-test-generator.agent?
- playwright-test-generate.prompt is described as generating a test plan, while playwright-test-generator.agent is described as the one to use when you need to create automated browser tests using Playwright. Both sit in the same generation family, alongside a matching pair for test planning and a matching pair for fixing failing tests.
- Is the microsoft/playwright plugin only useful for people who work on Playwright itself?
- No. Most of it, the test planning, generating, and healing agents plus the playwright-cli, playwright-component-testing, playwright-trace, playwright-test-results, and playwright-triage skills, is for any team that already tests with Playwright. Only two skills, playwright-devops and playwright-dev, are built for people working inside the Playwright project's own codebase.
- How do I debug a failing Playwright test with this plugin?
- Reach for playwright-test-healer.agent or its matching playwright-test-heal.prompt, both described as fixing failing tests. playwright-trace can inspect the trace file for actions, requests, console output, and screenshots, and playwright-triage can reproduce a bug report from a GitHub issue if the failure was already filed there.
- How many skills and agents does the microsoft/playwright plugin ship?
- It ships 14 components in total: 7 agents (three matched prompt and agent pairs for planning, generating, and healing tests, plus a standalone coverage prompt) and 7 skills, playwright-cli, playwright-component-testing, playwright-trace, playwright-test-results, playwright-triage, playwright-devops, and playwright-dev. The exact install step lives on the plugin's listing page, not in this guide.
