# playwright-pro

playwright-pro — a skill for Claude Code, Codex, and Cursor. Generates Playwright end-to-end tests, builds Page Object structures, diagnoses flaky runs, and migrates suites from Cypress or Selenium.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 148 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/playwright-pro/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-playwright-pro

## What it does

Compatible with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It guides end-to-end test authoring based on user stories, covering both positive paths and edge failures. It also structures Page Object models directly from DOM markup and assists with CI configuration, including test sharding and trace retention.

Under the hood, the skill bundles Python command-line tools. The `test_analyzer.py` tool scans specs for brittle locators and fixed delays like `waitForTimeout`, `coverage_mapper.py` highlights missing scenario coverage, and `flaky_detector.py` evaluates run stability across Playwright JSON outputs. Dedicated modules also handle visual regressions with `toHaveScreenshot`, Axe accessibility checks, and BrowserStack or TestRail workflows.

Executing the built-in diagnostic and generator tools requires a local `python3` runtime.

## Requirements
- Works with: Playwright

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill playwright-pro -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/playwright-pro/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/playwright-pro/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill playwright-pro -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/playwright-pro/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill playwright-pro -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/playwright-pro/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/playwright-pro/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/playwright-pro/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill playwright-pro -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/playwright-pro
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/playwright-pro/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill playwright-pro -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/playwright-pro/SKILL.md

## When to use it
- generate resilient Playwright test suites from user flows
- construct Page Object classes out of raw HTML forms
- diagnose flaky CI executions without relying on arbitrary delays
- convert existing Cypress or Selenium test suites to Playwright
- audit test code for bad practices such as fixed timeouts

## Example prompts
- Create a Playwright test spec for the checkout flow covering card failure states
- Analyze our test directory using test_analyzer.py to find non-retrying assertions
- Map this Cypress login test over to a resilient Playwright Page Object

## Similar
- [cypress-playwright-setup](https://affpapa.org/en/nevibecode/skills/cypress-playwright-setup.md) — skill · 313 installs
- [playwright-testing](https://affpapa.org/en/nevibecode/skills/playwright-testing.md) — skill · 3400 installs
- [playwright](https://affpapa.org/en/nevibecode/skills/gentleman-programming-playwright.md) — skill · 194 installs
- [e2e-testing-automation](https://affpapa.org/en/nevibecode/skills/e2e-testing-automation.md) — skill · 698 installs
- [playwright-migration](https://affpapa.org/en/nevibecode/skills/playwright-migration.md) — skill · 454 installs

## Other versions with the same name
- [playwright-pro · alirezarezvani](https://affpapa.org/en/nevibecode/skills/playwright-pro.md) — 682 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
