@athenaflow/plugin-e2e-test-builder 2.0.9

package/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "e2e-test-builder",
+  "description": "Full-pipeline Playwright E2E test generation \u2014 explores your live site via browser, detects existing test conventions, plans coverage gaps, produces reviewed test specs, writes production-grade test code with quality gates, and stabilizes flaky tests",
+  "version": "2.0.9",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "keywords": [
+    "playwright",
+    "e2e",
+    "testing",
+    "test-generation",
+    "test-automation",
+    "browser-exploration",
+    "quality-gates",
+    "coverage-planning",
+    "flaky-test-fix"
+  ],
+  "category": "testing"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "e2e-test-builder",
+  "version": "2.0.9",
+  "description": "Full-pipeline Playwright E2E test generation \u2014 explores your live site via browser, detects existing test conventions, plans coverage gaps, produces reviewed test specs, writes production-grade test code with quality gates, and stabilizes flaky tests",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "E2E Test Builder",
+    "shortDescription": "Full-pipeline Playwright E2E test generation with browser exploration and quality gates",
+    "developerName": "Athenaflow",
+    "category": "Testing"
+  }
+}

package/dist/2.0.8/.agents/plugins/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "name": "athena-workflow-marketplace",
+  "plugins": [
+    {
+      "name": "e2e-test-builder",
+      "version": "2.0.8",
+      "source": {
+        "source": "local",
+        "path": "./codex/plugin"
+      }
+    }
+  ]
+}

package/dist/2.0.8/claude/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "e2e-test-builder",
+  "description": "Full-pipeline Playwright E2E test generation — explores your live site via browser, detects existing test conventions, plans coverage gaps, produces reviewed test specs, writes production-grade test code with quality gates, and stabilizes flaky tests",
+  "version": "2.0.8",
+  "author": {
+    "name": "Athenaflow"
+  },
+  "keywords": [
+    "playwright",
+    "e2e",
+    "testing",
+    "test-generation",
+    "test-automation",
+    "browser-exploration",
+    "quality-gates",
+    "coverage-planning",
+    "flaky-test-fix"
+  ],
+  "category": "testing"
+}

package/dist/2.0.8/claude/plugin/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@athenaflow/plugin-e2e-test-builder",
+  "version": "2.0.8",
+  "description": "Full-pipeline Playwright E2E test generation — explores your live site via browser, detects existing test conventions, plans coverage gaps, produces reviewed test specs, writes production-grade test code with quality gates, and stabilizes flaky tests",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/SKILL.md

@@ -0,0 +1,217 @@
+---
+name: add-e2e-tests
+description: >
+  THE DEFAULT ENTRY POINT for all Playwright / E2E test work. This skill should be used FIRST
+  whenever the user wants to add, create, or set up end-to-end tests for any feature, page, or
+  application. Runs the full pipeline: analyze codebase, explore the live site, plan coverage,
+  generate TC-ID specs, run quality-gate reviews, write production-grade test code, and execute.
+  Delegates to sub-skills (analyze-test-codebase, plan-test-coverage, generate-test-cases,
+  review-test-cases, write-test-code, review-test-code, fix-flaky-tests) internally — do NOT
+  skip to sub-skills directly unless the user explicitly requests a narrow activity.
+  Iterative and resumable via tracker file. Uses subagent delegation to save context.
+user-invocable: true
+argument-hint: "<url> <feature to test>"
+allowed-tools: Read Write Edit Glob Grep Bash Task
+---
+
+# Add E2E Tests
+
+Go from zero to passing Playwright tests for the target feature in one interactive session.
+
+## Input
+
+Parse the target URL and feature description from: $ARGUMENTS
+
+Derive a **feature slug** from the feature description (e.g., "Login flow" → `login`, "Checkout with payment" → `checkout`). Use this slug for file naming throughout.
+
+## Session Protocol
+
+### 1. Orient: Understand the Project, the Product, and Your Capabilities
+
+Before planning any work, build deep situational awareness. This step determines the quality of everything that follows — rushed orientation leads to missed test cases and wasted effort.
+
+**Check for existing progress:**
+- If `e2e-tracker.md` exists in the project root, read it and resume from where you left off — skip to **step 2 (Plan)** with the remaining work.
+- If no tracker exists, this is a fresh start. Proceed with orientation below.
+
+#### First: create initial tasks and tracker
+
+As soon as you parse the user's request:
+
+1. **Create the tracker** — write `e2e-tracker.md` with the goal (URL, feature, slug) and a skeleton plan.
+2. **Create high-level tasks** for the work ahead — analyze codebase, explore the product, plan coverage, generate test specs, write tests, verify tests.
+
+These are your starting skeleton. As you work through orientation and discover the actual shape of the work, refine both the tasks and the tracker — break tasks into granular sub-tasks, add new ones, remove ones that don't apply.
+
+Treat the task list as a visible milestone log. Keep it concise, but update it continuously. Do not leave broad tasks open until the end and then mark everything complete in one batch.
+
+#### 1a. Understand the codebase
+
+- Does a Playwright config exist (`playwright.config.{ts,js,mjs}`)? If not, you will need to scaffold one (see Scaffolding section).
+- Are there existing tests? What conventions do they follow — naming, locators, fixtures, page objects, auth?
+- Load the `analyze-test-codebase` skill and follow its methodology.
+
+#### 1b. Understand the product
+
+This is the most important part of orientation. You cannot write good tests for a product you don't understand.
+
+- **Read existing test cases** — if `test-cases/*.md` files exist, read them to understand what journeys have been mapped. Look at what's covered AND what's missing.
+- **Browse the actual product** — load the `agent-web-interface-guide` skill and use the browser MCP tools to walk through the feature you're testing. Don't just skim the page — interact with it as a user would: fill forms, click buttons, trigger validation, navigate between pages, check error states.
+- **Map the user journey in detail** — understand the complete flow: entry points, happy paths, error paths, edge cases, what happens with invalid input, what happens when the user goes back, what conditional UI exists.
+
+Why this matters: absent explicit exploration, agents tend to write tests based on assumptions about how a product works rather than how it actually works. The result is tests that target imaginary behavior or miss critical real behavior. Spending time here prevents both.
+
+#### 1c. Know your skills
+
+You have access to specialized skills that contain deep domain knowledge. Load the relevant skill before performing each activity — skills prevent improvisation and encode best practices.
+
+| Activity | Skill |
+|----------|-------|
+| Analyzing test setup, config, conventions | `analyze-test-codebase` |
+| Deciding what to test, coverage gaps, priorities | `plan-test-coverage` |
+| Opening a URL, browsing, using browser MCP tools | `agent-web-interface-guide` |
+| Creating TC-ID specs from site exploration | `generate-test-cases` |
+| Reviewing TC-ID specs before implementation | `review-test-cases` |
+| Writing, editing, or refactoring test code | `write-test-code` |
+| Reviewing test code before execution signoff | `review-test-code` |
+| Debugging test failures, checking stability | `fix-flaky-tests` |
+
+Before doing a substantial activity, load the skill that covers that activity so you can follow its workflow rather than improvising.
+
+#### 1d. Update the tracker with orientation findings
+
+After orienting, update the tracker with what you learned about the codebase and product, conventions discovered, and your refined plan. The tracker must always answer these four questions for anyone reading it cold:
+
+1. What is the goal?
+2. What has been done?
+3. What is remaining?
+4. What should I do next?
+
+See [references/tracker-template.md](references/tracker-template.md) for a concrete template.
+
+### 2. Plan: Refine Tasks Into Granular Checkpoints
+
+By now you have initial tasks and a tracker from step 1. Refine tasks into granular checkpoints. The plan should flow from what you learned during orientation, not from a fixed template.
+
+#### Task granularity
+
+Think in small checkpoints, not big phases. Each task should represent a concrete, verifiable unit of progress.
+
+Too coarse: "Analyze codebase", "Write tests", "Verify tests"
+
+Right granularity:
+- "Read playwright.config.ts — extract baseURL, testDir, projects"
+- "Read 2 existing test files — identify locator strategy and naming pattern"
+- "Write conventions report to e2e-plan/conventions.md"
+- "Navigate to /login — catalog all form fields, buttons, and validation messages"
+- "Submit login form empty — record all validation error messages and their positions"
+- "Submit login with invalid email format — record inline validation behavior"
+- "Write TC-LOGIN-001: happy path login with valid credentials"
+- "Write TC-LOGIN-002: login with empty email shows required field error"
+- "Run login.spec.ts and record full output"
+- "Fix TC-LOGIN-003: selector not found — browse page and re-extract selector"
+- "Re-run login.spec.ts — verify fix didn't break other tests"
+- "Check all TC-IDs from spec are present in test files"
+
+**Never be conservative.** More tasks is better than fewer. If you discover new work mid-session (a test fails, a selector changed, a form has unexpected validation), add tasks dynamically. The task list is a living document that reflects the real state of the work.
+
+Create tasks for verification steps too (running tests, checking coverage, browsing to confirm selectors), not just implementation.
+
+Update task status as each checkpoint completes. A good pattern is: finish exploration and mark it complete, finish coverage/spec work and mark it complete, finish implementation and mark it complete, then finish review/execution and mark it complete. Do not keep all milestones open until session end.
+
+### 3. Execute
+
+Work through your tasks. Load the relevant skill before each activity.
+
+#### Planning uses the browser heavily
+
+When planning what to test (coverage planning, test case generation), use the browser extensively. Don't just catalog elements — interact with the product to discover:
+- What validation messages appear for each field?
+- What happens when you submit with missing data?
+- What error states exist (network errors, empty states, permission errors)?
+- What does the flow look like end-to-end, not just page-by-page?
+- What edge cases exist (special characters, long inputs, rapid clicks)?
+- What UI changes conditionally (loading states, disabled buttons, progressive disclosure)?
+
+Every test case you generate should trace back to something you actually observed or deliberately triggered in the browser. This is how you avoid introducing useless test cases (testing imaginary behavior) and avoid missing important ones (behavior you didn't think to check).
+
+#### Subagent delegation
+
+Delegate heavy browser exploration and test writing to subagents when that saves context for orchestration, verification, and debugging. When delegating:
+- Pass the relevant file paths (conventions, coverage plan, test specs)
+- Instruct the subagent to invoke the appropriate skill (subagents inherit access to plugin skills)
+- Specify concrete output expectations (file path, format, TC-ID conventions)
+
+#### Quality gates
+
+Two review gates and a test execution checkpoint are mandatory during execution. The review gates are review-only — they produce findings but do not modify files.
+
+**Gate 1: Review test case specs** (after `generate-test-cases`, before `write-test-code`)
+1. Load the `review-test-cases` skill and run it against `test-cases/<feature>.md`
+2. If verdict is **NEEDS REVISION** — address all blockers in the spec before proceeding to implementation
+3. If verdict is **PASS WITH WARNINGS** — address warnings if quick, otherwise note them and proceed
+4. Record the review verdict in the tracker
+
+**Gate 2: Review test code** (after `write-test-code`, before final test execution)
+1. Load the `review-test-code` skill and run it against the implemented test files
+2. If verdict is **NEEDS REVISION** — fix all blockers before running tests for signoff
+3. If verdict is **PASS WITH WARNINGS** — fix warnings that affect stability, proceed with execution
+4. Record the review verdict in the tracker
+
+**Checkpoint: Test execution**
+1. Run the tests: `npx playwright test <file> --reporter=list 2>&1`
+2. Record full output — green test output is the only proof of correctness
+3. If tests fail, load the `fix-flaky-tests` skill and follow its structured diagnostic approach. Do not guess-and-retry.
+4. Maximum 3 fix-and-rerun cycles per test. If stuck after 3 cycles, record the diagnostic output in the tracker and move on.
+
+**Test execution and coverage checks must never be delegated to subagents.** Run `npx playwright test` directly and record the output.
+
+#### Update the tracker as you work
+
+Do not wait until session end. After each meaningful chunk of progress (completing a step, discovering a blocker, producing an artifact), update the tracker. If your context window resets, only what's in the tracker survives.
+
+Keep the tracker and task list synchronized. If you record progress in the tracker, update the corresponding task status in the same phase of work.
+
+#### Error recovery
+
+If infrastructure failures occur (browser MCP unavailable, clone failures, npm install errors), see [references/error-recovery.md](references/error-recovery.md) for diagnostic steps. General pattern: diagnose, attempt one known fix, if still stuck record in tracker and ask the user.
+
+### 4. End of Session
+
+Before exiting:
+1. Ensure the tracker reflects all progress, discoveries, and blockers from this session
+2. Write clear instructions for what the next session should do
+3. If all work is complete and all tests pass with full TC-ID coverage: write `<!-- E2E_COMPLETE -->` as the last line of the tracker
+4. If an unrecoverable blocker prevents progress: write `<!-- E2E_BLOCKED: reason -->` as the last line
+
+Do not write terminal markers prematurely. Only after you are confident the work is truly done or truly stuck.
+
+## Scaffolding
+
+If Playwright is not set up in the target project, follow the procedure in [references/scaffolding.md](references/scaffolding.md) to clone the boilerplate, merge configuration, and install dependencies. Log all scaffolding steps in the tracker.
+
+## Authentication
+
+If the target feature requires login, follow [references/authentication.md](references/authentication.md). Key rule: never hardcode credentials — use environment variables or `storageState`.
+
+## Principles
+
+- **Skills carry the knowledge** — load the relevant skill before each activity; do not improvise
+- **Subagent-driven** — delegate heavy browser and writing work to subagents to save context
+- **Follow existing conventions** — match the project's test style, not a generic template
+- **Traceable** — every test links back to a TC-ID from the spec
+- **Use what the project provides** — if the scaffolded boilerplate includes Page Object Models (BasePage, pages/), path aliases (tsconfig paths), or utility modules, USE them in generated tests. Do not ship infrastructure that tests ignore. If a boilerplate file is unused after test generation, either integrate it or remove it — dead code in test infrastructure causes confusion.
+- **No arbitrary waits** — use Playwright's built-in auto-wait and event-driven waits
+- **API before UI for setup** — use API calls (`request` fixture) for test data; reserve UI for what you are verifying
+- **Test failures, not just success** — every feature needs error path coverage
+- **Artifacts live in standard locations** — `e2e-plan/` for analysis, `test-cases/` for specs, project test dir for test files
+
+## Example Usage
+
+```
+Claude Code: /add-e2e-tests https://myapp.com/checkout Checkout flow with cart, shipping, and payment
+Codex: $add-e2e-tests https://myapp.com/checkout Checkout flow with cart, shipping, and payment
+
+Claude Code: /add-e2e-tests https://myapp.com/login User authentication including social login
+Codex: $add-e2e-tests https://myapp.com/login User authentication including social login
+```

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/agents/claude.yaml

@@ -0,0 +1 @@
+{}

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/agents/openai.yaml

@@ -0,0 +1,10 @@
+interface:
+  display_name: "Run Full E2E Workflow"
+  short_description: "Orchestrate browser-led E2E work from exploration to verified tests"
+  default_prompt: "Run the full E2E workflow for this feature: maintain a concise progress tracker, explore the live product first, then plan, spec, review, implement, and verify the Playwright tests."
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "agent-web-interface"
+      description: "Browser automation MCP used to explore the site and verify flows"

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/references/authentication.md

@@ -0,0 +1,8 @@
+# Authentication Handling for E2E Tests
+
+If the target feature requires login or any form of authentication:
+
+1. **Check existing infrastructure** — look for existing test fixtures, environment variables, or auth setup files that already handle authentication. Load the `analyze-test-codebase` skill to find auth patterns.
+2. **Ask the user if no auth setup exists** — request credentials or an auth strategy (stored auth state, API tokens, test accounts). Do not proceed with tests that require login until auth is resolved.
+3. **Never hardcode credentials** — use environment variables, Playwright's `storageState`, or the project's existing auth fixture pattern.
+4. **Handle mid-session auth discovery** — if you discover auth is needed mid-session (e.g., a page redirects to login), ask the user immediately and add auth setup as a prerequisite task.

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/references/error-recovery.md

@@ -0,0 +1,43 @@
+# Error Recovery for Infrastructure Failures
+
+When infrastructure failures occur during E2E test building, follow the general pattern: diagnose, attempt one known fix, if still stuck record in tracker and ask the user.
+
+## Browser MCP unavailable
+
+The browser MCP server (`agent-web-interface`) must be running for site exploration.
+
+1. Verify the MCP server is configured in the project (check `.mcp.json` or plugin config).
+2. Ask the user to confirm the MCP server is running or to restart it.
+3. If unreachable after user intervention, mark the session as blocked: `<!-- E2E_BLOCKED: browser MCP server unreachable -->`.
+
+## Boilerplate clone fails
+
+When `git clone git@github.com:lespaceman/playwright-typescript-e2e-boilerplate.git` fails:
+
+1. Check if SSH keys are configured — the error will usually indicate `Permission denied (publickey)`.
+2. Fall back to HTTPS: `git clone https://github.com/lespaceman/playwright-typescript-e2e-boilerplate.git`.
+3. If both fail, ask the user to verify network access and GitHub authentication.
+
+## npm install fails
+
+1. Check the Node.js version — Playwright requires Node 18+. Run `node --version`.
+2. Clear the npm cache: `npm cache clean --force`.
+3. Check for lockfile conflicts — if both `package-lock.json` and `yarn.lock` exist, ask the user which package manager to use.
+4. If dependency resolution fails, try `npm install --legacy-peer-deps` as a fallback.
+
+## Playwright browser install fails
+
+When `npx playwright install --with-deps chromium` fails:
+
+1. Try installing just chromium without system deps: `npx playwright install chromium`.
+2. Check permissions — on Linux, system dependency installation may require sudo.
+3. If behind a corporate proxy, ask the user for proxy configuration.
+4. As a last resort, ask the user to run the install command manually and confirm when done.
+
+## General pattern
+
+For any infrastructure failure not listed above:
+
+1. **Diagnose** — read the error message carefully, check logs, identify the root cause.
+2. **Attempt one known fix** — apply the most likely solution based on the error.
+3. **If still stuck** — record the full error output and diagnostic steps taken in the tracker, then ask the user for help. Do not loop through multiple speculative fixes.

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/references/scaffolding.md

@@ -0,0 +1,12 @@
+# Scaffolding Playwright from Boilerplate
+
+If Playwright is not set up in the target project, follow this procedure:
+
+1. Clone `git@github.com:lespaceman/playwright-typescript-e2e-boilerplate.git` into a temporary directory.
+2. Copy config, fixtures, pages, and utils into the project. Do not overwrite existing files.
+3. Update `baseURL` to the target URL and remove example tests.
+   - **Test execution strategy:** If the project needs role-based or category-based test filtering, configure it via Playwright `--grep` tags or file naming conventions (`*.admin.spec.ts`), NOT via `testIgnore` regex patterns. A `testIgnore` regex becomes a maintenance trap — every new test file requires updating the regex. If the boilerplate includes a `testIgnore` regex, replace it with tag-based filtering.
+4. Merge devDependencies into `package.json`.
+5. Run `npm install && npx playwright install --with-deps chromium`.
+6. Clean up the temp clone.
+7. Log all scaffolding steps in the tracker.

package/dist/2.0.8/claude/plugin/skills/add-e2e-tests/references/tracker-template.md

@@ -0,0 +1,53 @@
+# Tracker Template: e2e-tracker.md
+
+Use this as a starting template when creating the tracker file. Adapt sections as needed.
+
+---
+
+```markdown
+# E2E Test Tracker
+
+## Goal
+
+- **URL:** https://myapp.com/checkout
+- **Feature:** Checkout flow with cart, shipping, and payment
+- **Slug:** checkout
+
+## Progress
+
+### Session 1 — 2026-04-01
+
+- Analyzed codebase: Playwright 1.42, TypeScript, existing auth fixture in `tests/fixtures/auth.ts`
+- Browsed checkout flow: 4-step wizard (cart review, shipping, payment, confirmation)
+- Discovered 3 form validation states per step
+- Generated test spec: `test-cases/checkout.md` with TC-CHECKOUT-001 through TC-CHECKOUT-012
+- Review gate passed with warnings (TC-CHECKOUT-008 needs clarification on coupon edge case)
+
+### Session 2 — 2026-04-02
+
+- Wrote `tests/checkout.spec.ts` covering TC-CHECKOUT-001 through TC-CHECKOUT-012
+- Code review gate passed
+- Ran tests: 10/12 passing, 2 failing (TC-CHECKOUT-006: selector stale, TC-CHECKOUT-011: timeout)
+- Fixed TC-CHECKOUT-006: updated selector from `.price` to `[data-testid="cart-total"]`
+- Fixed TC-CHECKOUT-011: added `waitForResponse` before assertion
+
+## Remaining
+
+- Re-run full suite to confirm fixes
+- Verify TC-ID coverage: all 12 specs should map to test code
+
+## Next Steps
+
+- Run `npx playwright test tests/checkout.spec.ts --reporter=list` and record output
+- If all green, mark complete
+- If failures remain, diagnose with `fix-flaky-tests` skill
+
+<!-- E2E_COMPLETE -->
+```
+
+---
+
+**Terminal markers** (write as the last line of the tracker when appropriate):
+
+- `<!-- E2E_COMPLETE -->` — all tests pass, all TC-IDs covered, work is done
+- `<!-- E2E_BLOCKED: reason -->` — unrecoverable blocker prevents further progress (e.g., `<!-- E2E_BLOCKED: login requires 2FA token we cannot automate -->`)

package/dist/2.0.8/claude/plugin/skills/analyze-test-codebase/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: analyze-test-codebase
+description: >
+  Scans and reports on an existing Playwright test codebase. This skill should be used to inspect
+  the current Playwright setup before writing, reviewing, or fixing tests, and should be loaded
+  early when working in a new project to understand existing patterns. Covers: Playwright config,
+  page objects, fixtures, helpers, auth/globalSetup patterns, test conventions, and directory
+  structure. Triggers: "understand", "check", "show me", "inspect", or "analyze"
+  the current test setup, config, infrastructure, patterns, or conventions. In the full add-tests
+  workflow, this skill serves as an early read-only analysis sub-step before planning detailed
+  coverage or writing code. This skill examines existing files and outputs a structured report.
+  It does NOT write or fix tests, install Playwright, or explore live websites — for live site
+  exploration, use agent-web-interface-guide instead.
+allowed-tools: Read Glob Grep Bash
+---
+
+# Analyze Test Codebase
+
+Scan and analyze an existing Playwright test codebase to understand its conventions, configuration, and patterns before writing new tests.
+
+## Workflow
+
+1. **Locate Playwright configuration** — search for `playwright.config.ts`, `playwright.config.js`, or `playwright.config.mjs` in the project root and common subdirectories.
+
+2. **Extract configuration details**:
+   - `baseURL` — the target application URL
+   - `testDir` — where tests live
+   - `projects` — browser/device configurations
+   - `use` — default options (viewport, headless, trace, screenshot)
+   - `webServer` — if Playwright starts the app
+   - `globalSetup` / `globalTeardown` — auth or data seeding scripts
+   - `reporter` — configured reporters
+
+3. **Scan test directory structure**:
+   ```
+   Glob for **/*.spec.ts, **/*.test.ts, **/*.spec.js, **/*.test.js
+   ```
+   - Count total test files
+   - Identify naming conventions (`.spec.ts` vs `.test.ts`)
+   - Map directory organization (by feature? by page? flat?)
+
+4. **Detect patterns in existing tests** — read 2-3 representative test files and identify:
+   - **Locator strategy**: `getByRole`, `getByTestId`, CSS selectors, XPath
+   - **Wait strategy**: auto-waits, explicit `waitFor*`, any `waitForTimeout` (flag these)
+   - **Test structure**: AAA pattern, describe/test nesting, use of `test.step`
+   - **Data management**: fixtures, test data files, factory functions
+   - **Page Objects**: POM pattern usage, fixture-based injection
+   - **Auth handling**: `storageState`, global setup, per-test login
+   - **Custom fixtures**: extended `test` with custom fixtures
+   - **Helper utilities**: shared functions, custom assertions
+   - **Network mocking**: `page.route()` usage, HAR recording (`routeFromHAR`), API interceptors
+   - **Visual regression**: `toHaveScreenshot()`, `toMatchSnapshot()`, snapshot directories
+   - **Accessibility testing**: `@axe-core/playwright` usage, custom a11y assertions
+   - **Cross-browser config**: multiple projects in playwright.config (chromium, firefox, webkit)
+   - **Retry configuration**: `retries` count, trace settings (`on-first-retry`)
+   - **Parallelism**: `fullyParallel`, `workers` count, test isolation strategy
+
+5. **Check for supporting infrastructure**:
+   - `fixtures/` or `helpers/` directories
+   - `pages/` or `pom/` (Page Object Model)
+   - `.env` or `.env.test` files (test-specific environment configuration)
+   - CI configuration (`.github/workflows/`, `Jenkinsfile`, etc.)
+   - `package.json` scripts for running tests
+   - `*.har` files or HAR directories (recorded API responses for mocking)
+   - Snapshot directories (`__snapshots__`, `screenshots/`) for visual regression baselines
+   - Docker or `docker-compose` for test environment setup
+   - Global setup/teardown scripts — what they do (auth, seeding, cleanup)
+
+6. **Generate report** — output a structured summary:
+
+```markdown
+## Test Codebase Analysis
+
+### Framework
+- **Playwright** version X.Y.Z
+- Config: `playwright.config.ts`
+- Test directory: `tests/`
+
+### Conventions
+- File naming: `*.spec.ts`
+- Locator preference: getByRole > getByTestId
+- Structure: describe blocks by feature
+- Page Objects: Yes, in `tests/pages/`
+- Custom fixtures: Yes, in `tests/fixtures/`
+
+### Auth
+- Method: storageState via global setup
+- Auth file: `tests/.auth/user.json`
+
+### Existing Coverage
+- Total test files: N
+- Feature areas covered: [list]
+- Test count: ~N tests
+
+### Network Mocking
+- Method: page.route() / HAR / none
+- Patterns: [list any existing mocking patterns]
+
+### Visual Testing
+- Enabled: Yes/No
+- Tool: toHaveScreenshot() / third-party / none
+- Baseline directory: [path if exists]
+
+### Accessibility Testing
+- Enabled: Yes/No
+- Tool: @axe-core/playwright / custom assertions / none
+
+### Cross-Browser & CI
+- Browser projects: [list from config]
+- Retries: N (CI) / N (local)
+- Workers: N / fullyParallel: Yes/No
+- CI platform: GitHub Actions / Jenkins / none detected
+- Trace: [setting from config]
+
+### Recommendations for New Tests
+- Follow existing `*.spec.ts` naming
+- Use page objects from `tests/pages/`
+- Import test data from `tests/fixtures/testData.ts`
+- Use `baseURL` for navigation (relative paths)
+- Auth: reuse existing storageState setup
+```
+
+## Out of Scope
+
+This skill only reads and reports on the codebase. For related tasks, use the appropriate skill:
+
+| Task | Skill |
+|------|-------|
+| Browsing a live site, interacting with UI elements | `agent-web-interface-guide` |
+| Deciding what to test, coverage gaps, priorities | `plan-test-coverage` |
+| Writing or modifying executable test code | `write-test-code` |
+| Diagnosing flaky or failing tests | `fix-flaky-tests` |
+
+## Example Usage
+
+```
+Claude Code: /analyze-test-codebase
+Codex: $analyze-test-codebase
+
+Claude Code: /analyze-test-codebase ./my-app
+Codex: $analyze-test-codebase ./my-app
+```

package/dist/2.0.8/claude/plugin/skills/analyze-test-codebase/agents/claude.yaml

@@ -0,0 +1,3 @@
+frontmatter:
+  argument-hint: "[optional: path to project root]"
+  user-invocable: true

package/dist/2.0.8/claude/plugin/skills/analyze-test-codebase/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Analyze Existing Test Setup"
+  short_description: "Inspect Playwright conventions before planning or writing tests"
+  default_prompt: "Analyze this Playwright codebase and summarize the current setup as an early workflow step before planning detailed coverage or writing test code."