playwright-mcp-dev
Explains how to add and debug playwright MCP tools and CLI commands.
How do I install this agent skill?
npx skills add https://github.com/microsoft/playwright --skill playwright-mcp-devIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a documentation and development guide for developers working on Playwright MCP tools and CLI commands. It contains instructions for adding features, building, and testing, with no malicious patterns detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
MCP
Adding MCP Tools
- Create a new tool in
packages/playwright/src/mcp/browser/tools/your-tool.ts - Register the tool in
packages/playwright/src/mcp/browser/tools.ts - Add ToolCapability in
packages/playwright/src/mcp/config.d.ts - Place new tests in
tests/mcp/mcp-<category>.spec.ts
Building
- Assume watch is running at all times, run lint to see type errors
Testing
- Run tests as
npm run ctest-mcp <category> - Do not run test --debug
CLI
Adding commands
- CLI commands are based on MCP tools. Implement the corresponding MCP tool as per
Adding MCP Toolssection above, if needed. - Add new CLI category for tool if needed:
- Add Category in
packages/playwright/src/mcp/terminal/command.ts - Update doc generator
packages/playwright/src/mcp/terminal/helpGenerator.ts
- Add Category in
- Register command in
packages/playwright/src/mcp/terminal/commands.ts - Update skill file at
packages/playwright/src/skill/SKILL.mdand references if necessary inpackages/playwright/src/skill/references/ - Place new tests in
tests/mcp/cli-<category>.spec.ts
Adding CLI options or Config options
When you need to add something to config.
packages/playwright/src/mcp/program.ts- add CLI option and doc
packages/playwright/src/mcp/config.d.ts- add and document the option
packages/playwright/src/mcp/config.ts- modify FullConfig if needed
- and CLIOptions if needed
- add it to configFromEnv
Building
- Assume watch is running at all times, run lint to see type errors
Testing
- Run tests as
npm run ctest-mcp cli-<category> - Do not run test --debug
Lint
- run
npm run flintto lint everything before commit
SKILL File
The skill file is located at packages/playwright/src/skill/SKILL.md. It contains documentation for all available CLI commands and MCP tools. Update it whenever you add new commands or tools.
At any point in time you can run "npm run playwright-cli -- --help" to see the latest available commands and use them to update the skill file.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/microsoft/playwright/playwright-mcp-dev">View playwright-mcp-dev on skillZs</a>