E2e Test Writing
Testing & Qualitye2e-test-writingE2e Test Writing is an Agent Skill for testing & quality published in the Shopify/hydrogen repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Guide for writing high-quality Playwright E2E tests for Hydrogen. Use when the user asks to "write e2e tests", "add playwright tests", "test this feature end-to-end", "write recipe tests", "add integration tests", or mentions Playwright, E2E testing, or test coverage for user-facing features.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Shopify/hydrogen/blob/HEAD/.claude/skills/e2e-test-writing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/e2e-test-writing, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
/e2e-test-writing - E2E Test Writing for Hydrogen
Use this skill when implementing or reviewing Playwright E2E tests in this repository.
Syntax
/e2e-test-writing <task>
Examples:
/e2e-test-writing add recipe coverage for cart drawer quantity changes/e2e-test-writing review locator quality in e2e/tests/cart.test.ts
Source of Truth
- Follow
e2e/CLAUDE.mdfor all active test patterns and conventions. - Do not duplicate large guidance here; keep this skill as the entry point.
Core Expectations
- Prefer role-based, accessibility-first selectors.
- Assert user-visible behavior, not implementation details.
- Wait for visible effects (
expect,expect.poll), never arbitrary timeouts. - Keep tests isolated and organize shared setup with
beforeEachwhen it improves clarity. - Run Playwright tests in headless mode.
Workflow
- Read
e2e/CLAUDE.mdbefore writing tests. - Implement or update tests with user-centric assertions.
- Improve accessibility markup when it enables stronger locators.
- Run targeted Playwright tests first, then broader suites if needed.
Verification Commands
pnpm exec playwright test --project=skeleton
Use narrower test paths during iteration, then run the appropriate full project suite before finishing.