Playwright Pro
Production-grade Playwright testing toolkit for AI coding agents.
Available Commands
When installed as a Claude Code plugin, these are available as /pw: commands:
| Command |
What it does |
/pw:init |
Set up Playwright — detects framework, generates config, CI, first test |
/pw:generate <spec> |
Generate tests from user story, URL, or component |
/pw:review |
Review tests for anti-patterns and coverage gaps |
/pw:fix <test> |
Diagnose and fix failing or flaky tests |
/pw:migrate |
Migrate from Cypress or Selenium to Playwright |
/pw:coverage |
Analyze what's tested vs. what's missing |
/pw:testrail |
Sync with TestRail — read cases, push results |
/pw:browserstack |
Run on BrowserStack, pull cross-browser reports |
/pw:report |
Generate test report in your preferred format |
Golden Rules
getByRole() over CSS/XPath — resilient to markup changes
- Never
page.waitForTimeout() — use web-first assertions
expect(locator) auto-retries; expect(await locator.textContent()) does not
- Isolate every test — no shared state between tests
baseURL in config — zero hardcoded URLs
- Retries:
2 in CI, 0 locally
- Traces:
'on-first-retry' — rich debugging without slowdown
- Fixtures over globals —
test.extend() for shared state
- One behavior per test — multiple related assertions are fine
- Mock external services only — never mock your own app
Locator Priority
1. getByRole() — buttons, links, headings, form elements
2. getByLabel() — form fields with labels
3. getByText() — non-interactive text
4. getByPlaceholder() — inputs with placeholder
5. getByTestId() — when no semantic option exists
6. page.locator() — CSS/XPath as last resort
What's Included
- 9 skills with detailed step-by-step instructions
- 3 specialized agents: test-architect, test-debugger, migration-planner
- 55 test templates: auth, CRUD, checkout, search, forms, dashboard, settings, onboarding, notifications, API, accessibility
- 2 MCP servers (TypeScript): TestRail and BrowserStack integrations
- Smart hooks: auto-validate test quality, auto-detect Playwright projects
- 6 reference docs: golden rules, locators, assertions, fixtures, pitfalls, flaky tests
- Migration guides: Cypress and Selenium mapping tables
Integration Setup
TestRail (Optional)
export TESTRAIL_URL="https://your-instance.testrail.io"
export TESTRAIL_USER="your@email.com"
export TESTRAIL_API_KEY="your-api-key"
BrowserStack (Optional)
export BROWSERSTACK_USERNAME="your-username"
export BROWSERSTACK_ACCESS_KEY="your-access-key"
Quick Reference
See reference/ directory for:
golden-rules.md — The 10 non-negotiable rules
locators.md — Complete locator priority with cheat sheet
assertions.md — Web-first assertions reference
fixtures.md — Custom fixtures and storageState patterns
common-pitfalls.md — Top 10 mistakes and fixes
flaky-tests.md — Diagnosis commands and quick fixes
See templates/README.md for the full template index.
1---2name: playwright-pro3description: "Production-grade Playwright testing toolkit. Generate tests, fix flaky failures, migrate from Cypress/Selenium, sync with TestRail, run on BrowserStack. 55 templates, 3 agents, smart reporting."4metadata:5 source: https://skillmd.com/skills/realwigu/playwright-pro6---78# Playwright Pro910Production-grade Playwright testing toolkit for AI coding agents.1112## Available Commands1314When installed as a Claude Code plugin, these are available as `/pw:` commands:1516| Command | What it does |17|---|---|18| `/pw:init` | Set up Playwright — detects framework, generates config, CI, first test |19| `/pw:generate <spec>` | Generate tests from user story, URL, or component |20| `/pw:review` | Review tests for anti-patterns and coverage gaps |21| `/pw:fix <test>` | Diagnose and fix failing or flaky tests |22| `/pw:migrate` | Migrate from Cypress or Selenium to Playwright |23| `/pw:coverage` | Analyze what's tested vs. what's missing |24| `/pw:testrail` | Sync with TestRail — read cases, push results |25| `/pw:browserstack` | Run on BrowserStack, pull cross-browser reports |26| `/pw:report` | Generate test report in your preferred format |2728## Golden Rules29301. `getByRole()` over CSS/XPath — resilient to markup changes312. Never `page.waitForTimeout()` — use web-first assertions323. `expect(locator)` auto-retries; `expect(await locator.textContent())` does not334. Isolate every test — no shared state between tests345. `baseURL` in config — zero hardcoded URLs356. Retries: `2` in CI, `0` locally367. Traces: `'on-first-retry'` — rich debugging without slowdown378. Fixtures over globals — `test.extend()` for shared state389. One behavior per test — multiple related assertions are fine3910. Mock external services only — never mock your own app4041## Locator Priority4243```441. getByRole() — buttons, links, headings, form elements452. getByLabel() — form fields with labels463. getByText() — non-interactive text474. getByPlaceholder() — inputs with placeholder485. getByTestId() — when no semantic option exists496. page.locator() — CSS/XPath as last resort50```5152## What's Included5354- **9 skills** with detailed step-by-step instructions55- **3 specialized agents**: test-architect, test-debugger, migration-planner56- **55 test templates**: auth, CRUD, checkout, search, forms, dashboard, settings, onboarding, notifications, API, accessibility57- **2 MCP servers** (TypeScript): TestRail and BrowserStack integrations58- **Smart hooks**: auto-validate test quality, auto-detect Playwright projects59- **6 reference docs**: golden rules, locators, assertions, fixtures, pitfalls, flaky tests60- **Migration guides**: Cypress and Selenium mapping tables6162## Integration Setup6364### TestRail (Optional)65```bash66export TESTRAIL_URL="https://your-instance.testrail.io"67export TESTRAIL_USER="your@email.com"68export TESTRAIL_API_KEY="your-api-key"69```7071### BrowserStack (Optional)72```bash73export BROWSERSTACK_USERNAME="your-username"74export BROWSERSTACK_ACCESS_KEY="your-access-key"75```7677## Quick Reference7879See `reference/` directory for:80- `golden-rules.md` — The 10 non-negotiable rules81- `locators.md` — Complete locator priority with cheat sheet82- `assertions.md` — Web-first assertions reference83- `fixtures.md` — Custom fixtures and storageState patterns84- `common-pitfalls.md` — Top 10 mistakes and fixes85- `flaky-tests.md` — Diagnosis commands and quick fixes8687See `templates/README.md` for the full template index.