borghei/Claude-Skills / engineering/playwright-pro
playwright-pro
VerifiedEnd-to-end testing with Playwright: test generation, page objects, locator strategy, flaky- test diagnosis, visual regression, and CI integration. Use when writing E2E tests, fixing flaky tests, or migrating from Cypress/Selenium.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.6 KB |
| assets/flawed_tests/profile.spec.ts | script | 468 B |
| assets/reports/run1.json | config | 1.2 KB |
| assets/reports/run2.json | config | 1.3 KB |
| assets/reports/run3.json | config | 1.4 KB |
| assets/sample_flows.json | config | 800 B |
| assets/sample_login.html | other | 489 B |
| assets/tests/login.spec.ts | script | 906 B |
| references/core-rules-and-patterns.md | markdown | 7.2 KB |
| references/diagnosis-migration-and-ci.md | markdown | 8.7 KB |
| references/playwright-patterns.md | markdown | 4.5 KB |
| scripts/coverage_mapper.py | script | 11.0 KB |
| scripts/flaky_detector.py | script | 10.6 KB |
| scripts/page_object_generator.pyexecutable | script | 14.8 KB |
| scripts/test_analyzer.pyexecutable | script | 12.3 KB |
| scripts/test_generator.py | script | 11.1 KB |
| scripts/test_report_parser.pyexecutable | script | 14.8 KB |
| skills/browserstack.md | markdown | 2.4 KB |
| skills/coverage.md | markdown | 1.9 KB |
| skills/fix.md | markdown | 2.6 KB |
| skills/generate.md | markdown | 2.4 KB |
| skills/init.md | markdown | 2.1 KB |
| skills/migrate.md | markdown | 2.5 KB |
| skills/report.md | markdown | 2.0 KB |
| skills/review.md | markdown | 2.2 KB |
| skills/testrail.md | markdown | 2.5 KB |
skills/review.md
View on GitHub# Sub-Skill: Test Quality Review
**Parent:** playwright-pro
**Trigger:** "review test quality", "audit Playwright tests", "check test coverage gaps"
## Purpose
Review a Playwright test suite for quality issues, coverage gaps, anti-patterns, and flaky test indicators. Produces an actionable report with prioritized fixes.
## Workflow
### Step 1: Run Static Analysis
Use the `test_analyzer.py` script to scan for anti-patterns:
```bash
python scripts/test_analyzer.py ./tests/e2e/ --severity low
```
This catches: `waitForTimeout`, CSS/XPath selectors, missing assertions, `force:true` clicks, hardcoded URLs.
### Step 2: Assess Coverage
Map tests to critical user journeys:
- Login / Authentication
- Core CRUD operations
- Checkout / Payment (if applicable)
- Onboarding flow
- Error handling paths
Flag any critical journey without dedicated tests.
### Step 3: Check Flaky Indicators
Review recent CI runs for:
- Tests that needed retries to pass
- Tests with inconsistent durations (>2x variation)
- Tests that were recently disabled or skipped
Use `flaky_detector.py` on CI results:
```bash
python scripts/flaky_detector.py --results-dir ./test-results/ --runs 10
```
### Step 4: Review Architecture
- Every tested page has a Page Object class
- No raw locators in spec files
- `test.describe()` groups are logical
- Fixtures used for shared setup (not global variables)
- Auth setup project configured (not per-test login)
### Step 5: Generate Report
Produce a prioritized report:
1. **Critical:** Tests with no assertions, hardcoded waits, flaky tests above 5% rate
2. **High:** Missing coverage for critical user journeys
3. **Medium:** CSS selectors that should be semantic, missing Page Objects
4. **Low:** Style inconsistencies, test naming conventions
## Inputs
| Input | Required | Description |
|-------|----------|-------------|
| Test directory | Yes | Path to Playwright test files |
| CI results | No | Recent test result JSON files for flaky analysis |
| User journeys | No | List of critical flows to check coverage against |
## Outputs
- Anti-pattern report with line-level findings
- Coverage gap analysis
- Flaky test list with stability scores
- Prioritized fix recommendations
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |