mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00

fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885 , #969 follow-through)

Round-2 sweep after re-auditing all 15 reported issues against the merged dev:

- #885 generalized: the original fix only renamed self-improving-agent's
  status/review, but three more plugins shipped skills whose bare names
  shadow Claude Code built-ins. Renamed with the same convention:
  playwright-pro init/review -> pw-init/pw-review, agenthub init/status ->
  hub-init/hub-status, autoresearch-agent status/resume -> ar-status/
  ar-resume. All command references (/pw: /hub: /ar:), docs, audit records,
  harness manifests, and mirror trees/indexes updated; the flat mirror
  namespace no longer collides on 'status'. New scripts/check_skill_names.py
  gate (wired into ci-quality-gate.yml as blocking) fails CI on any future
  bare reserved name; rule added to SKILL-AUTHORING-STANDARD.md.
- #969 follow-through: five more scripts print box-drawing characters that
  cannot exist in cp1252 (api_scorecard, api_linter,
  breaking_change_detector, humanizer_scorer, content_scorer) — same
  guarded UTF-8 reconfigure applied; all smoke-tested under a forced
  legacy encoding.

Verified: check_skill_names (incl. negative test), check_plugin_json,
check_paths, derive_counters, check_dual_publish, smoke_scripts (634/634),
0 broken mirror symlinks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4

2026-08-21 08:38:50 +00:00

4.4 KiB

Raw Blame History

Playwright Pro

Production-grade Playwright testing toolkit for AI coding agents.

Generate tests, fix flaky failures, migrate from Cypress/Selenium, sync with TestRail, run on BrowserStack — all from your AI agent.

Install

# Claude Code plugin
claude plugin install pw@claude-skills

# Or load directly
claude --plugin-dir ./engineering-team/playwright-pro

Commands

Command	What it does
`/pw:pw-init`	Set up Playwright in your project — detects framework, generates config, CI, first test
`/pw:generate <spec>`	Generate tests from a user story, URL, or component name
`/pw:pw-review`	Review existing tests for anti-patterns and coverage gaps
`/pw:fix <test>`	Diagnose and fix a failing or flaky test
`/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, create runs
`/pw:browserstack`	Run tests on BrowserStack, pull cross-browser reports
`/pw:report`	Generate a test report in your preferred format

Quick Start

# In Claude Code:
/pw:pw-init                              # Set up Playwright
/pw:generate "user can log in"        # Generate your first test
# Tests are auto-validated by hooks — no extra steps

What's Inside

9 Skills

Slash commands that turn natural language into production-ready Playwright tests. Each skill leverages Claude Code's built-in capabilities (/batch for parallel work, Explore for codebase analysis, /debug for trace inspection).

3 Specialized Agents

test-architect — Plans test strategy for complex applications
test-debugger — Diagnoses flaky tests using a systematic taxonomy
migration-planner — Creates file-by-file migration plans from Cypress/Selenium

55 Test Templates

Ready-to-use, parametrizable templates covering:

Category	Count	Examples
Authentication	8	Login, logout, SSO, MFA, password reset, RBAC
CRUD	6	Create, read, update, delete, bulk ops
Checkout	6	Cart, payment, coupon, order history
Search	5	Basic search, filters, sorting, pagination
Forms	6	Multi-step, validation, file upload
Dashboard	5	Data loading, charts, export
Settings	4	Profile, password, notifications
Onboarding	4	Registration, email verify, welcome tour
Notifications	3	In-app, toast, notification center
API	5	REST CRUD, GraphQL, error handling
Accessibility	3	Keyboard nav, screen reader, contrast

2 MCP Integrations

TestRail — Read test cases, create runs, push pass/fail results
BrowserStack — Trigger cross-browser runs, pull session reports with video/screenshots

Smart Hooks

Auto-validates test quality when you write *.spec.ts files
Auto-detects Playwright projects on session start
Zero configuration required

Integrations Setup

TestRail (Optional)

Set environment variables:

export TESTRAIL_URL="https://your-instance.testrail.io"
export TESTRAIL_USER="your@email.com"
export TESTRAIL_API_KEY="your-api-key"

Then use /pw:testrail to sync test cases and push results.

BrowserStack (Optional)

export BROWSERSTACK_USERNAME="your-username"
export BROWSERSTACK_ACCESS_KEY="your-access-key"

Then use /pw:browserstack to run tests across browsers.

Works With

Agent	How
Claude Code	Full plugin — slash commands, MCP tools, hooks, agents
Codex CLI	Copy `CLAUDE.md` to your project root as `AGENTS.md`
OpenClaw	Use as a skill with `SKILL.md` entry point

Built-in Command Integration

Playwright Pro doesn't reinvent what your AI agent already does. It orchestrates built-in capabilities:

/pw:generate uses Claude's Explore subagent to understand your codebase before generating tests
/pw:migrate uses /batch for parallel file-by-file conversion on large test suites
/pw:fix uses /debug for trace analysis alongside Playwright-specific diagnostics
/pw:pw-review extends /review with Playwright anti-pattern detection

Reference

Based on battle-tested patterns from production test suites. Includes curated guidance on:

Locator strategies and priority hierarchy
Assertion patterns and auto-retry behavior
Fixture architecture and composition
Common pitfalls (top 20, ranked by frequency)
Flaky test diagnosis taxonomy

License

MIT

4.4 KiB Raw Blame History