OpenELIS-Global-2: Skill for Claude Code

Playwright Skill

Use this skill when:

• planning one or multiple Playwright flows for a feature or PR
• authoring new Playwright tests
• debugging failing Playwright tests
• auditing existing tests for flaky selectors or anti-patterns

Primary Entrypoints

• /plan-record-playwright - plan scope and flow inventory for one or multiple tests, then orchestrate write, audit, run, and recording stages
• /write-playwright-test - author new tests from requirements and register them correctly in Playwright project allowlists
• /debug-playwright - failure diagnosis and remediation workflow
• /audit-playwright - quality and maintainability audit workflow

Lifecycle

For AI-assisted development, prefer this sequence:

1. /plan-record-playwright
2. /write-playwright-test
3. /audit-playwright
4. /debug-playwright (only when failures persist)

Core Non-Negotiables

• Read component/page-object/helper source before changing selectors.
• For failures, inspect screenshot/trace/runtime DOM before changing code.
• Prefer data-testid, getByRole, and getByLabel over CSS fallback chains.
• Avoid .first() unless uniqueness is proven and documented.
• Use videoPause() for demo pacing and avoid page.waitForTimeout() for waits.
• Do not create new Cypress tests. Cypress is deprecated; all new E2E work must use Playwright.
• NEVER use response.ok() as the test pass/fail signal. Use waitForResponse for sync, assert on visible UI.
• NEVER use { force: true } on Carbon inputs. Click the <label> instead.
• NEVER use .catch(() => false) on isVisible() — it returns boolean directly.
• ALWAYS include at least one expect() assertion per test.
• Isolation (Constitution V.7): write and read only data the spec seeded. Scope every list, count, rate, or enabled state to your seeded IDs or assert a before and after delta; a date window is not a scope. Never widen an assertion because other data might be present. Use explicit dates and freeze or inject the clock used by the code under test when it reads the current time, including the server clock when applicable. A live server's "today" is not pinned time. For current-date behavior, set that clock to the dates or boundaries being exercised.