К основному содержанию
скилл CX Codex

e2e-testing · oakoss — скилл для Claude Code: что делает и как установить

Скилл e2e-testing помогает ИИ-агенту проектировать архитектуру E2E-тестов на Playwright: от Page Object Model и шардинга в CI до моков сети и проверок доступности.

MIT 142 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill e2e-testing -a claude-code
Открыть на GitHub

Что делает e2e-testing

Скилл задаёт правила и шаблоны сквозного тестирования на Playwright. В него заложены практики организации Page Object Model, единой авторизации через storageState, изоляции контекстов через BrowserContext, запуска визуальной регрессии с маскированием и аудита доступности через @axe-core/playwright.

Внутри собраны рекомендации по настройке CI: шардинг через --shard=1/N, сбор отчётов с blob и перезапуск только изменённых тестов с флагом --only-changed. Для ускорения прогонов предлагается блокировать тяжёлые изображения через page.route(), а тайм-ауты заменять на автоожидание веб-ассертов вроде expect(element).toBeVisible().

Учтите, что storageState сохраняет только куки и localStorage, поэтому для сохранения sessionStorage придётся подключать addInitScript(). Если нужны детали низкоуровневого API автоматизации браузера или парсинг страниц, для этого предназначен отдельный скилл playwright.

Какие задачи решает

  • спроектировать структуру Page Object Model для тестового набора
  • настроить параллельный запуск тестов в CI через шардинг
  • организовать авторизацию тестов один раз через storageState
  • встроить аудит доступности с помощью axe-core

Примеры запросов агенту

  • Спроектируй структуру тестов для оформления заказа на Playwright с использованием Page Object Model
  • Помоги настроить авторизацию через storageState и шардинг тестов в GitHub Actions
  • Добавь аудит доступности страниц через axe-core в наши Playwright тесты

Как установить e2e-testing

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill e2e-testing -a claude-code

2Вручную: положить файлы

~/.claude/skills/e2e-testing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/e2e-testing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об e2e-testing

Как установить e2e-testing в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill e2e-testing -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/e2e-testing/SKILL.md.

Чем e2e-testing отличается от скилла playwright?

Скилл e2e-testing отвечает за архитектуру тестового набора, фикстуры, CI-шардинг и паттерны тестирования. Для прямого вызова API автоматизации браузера и парсинга страниц используется отдельный скилл playwright.

Как скилл предлагает управлять авторизацией в тестах?

Рекомендуется авторизоваться один раз через setup-проекты и сохранять состояние в storageState. Каталог playwright/.auth/ при этом нужно обязательно добавить в .gitignore.

Исходный текст

SKILL.md · MIT
---
name: e2e-testing
description: 'E2E test architecture and patterns with Playwright. Use when designing test suites, structuring Page Object Models, planning CI sharding strategies, setting up authentication flows, or organizing tests with tags and annotations. Use for test architecture, accessibility auditing with axe-core, network mocking strategies, visual regression workflows, HAR replay, and storageState authentication patterns. For Playwright API details, browser automation, or web scraping, use the playwright skill instead.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
user-invocable: false
---

# E2E Testing

## Overview

Covers E2E test architecture and patterns using Playwright — how to structure test suites, organize tests, and apply proven patterns for authentication, mocking, visual regression, accessibility auditing, and CI parallelism. Focuses on the WHY and WHEN of test patterns rather than Playwright API specifics.

**When to use:** Designing test suite architecture, structuring Page Object Models, planning CI sharding strategies, setting up authentication flows, organizing tests with tags and annotations, implementing visual regression workflows, mocking network requests, auditing accessibility.

**When NOT to use:** Unit testing (use Vitest/Jest), API-only testing (use integration tests), component testing in isolation (use component test runners). For Playwright API details, browser automation, scraping, or troubleshooting Playwright errors, use the `playwright` skill.

## Quick Reference

| Pattern               | API/Tool                                  | Key Points                                         |
| --------------------- | ----------------------------------------- | -------------------------------------------------- |
| Role-based locators   | `getByRole`, `getByText`, `getByLabel`    | Preferred over CSS/XPath selectors                 |
| Page Object Model     | Classes in `tests/pages/`                 | Encapsulate all page-specific locators and actions |
| Authentication        | `storageState` + setup projects           | Authenticate once, reuse across tests              |
| Visual regression     | `expect(page).toHaveScreenshot()`         | Mask dynamic content to prevent flakes             |
| Accessibility audit   | `AxeBuilder` from `@axe-core/playwright`  | `.withTags()` + `.analyze()` on key flows          |
| Trace debugging       | `trace: 'on-first-retry'`                 | Full DOM snapshots, network logs, and timeline     |
| Network mocking       | `page.route()`                            | Stable tests without third-party dependencies      |
| HAR replay            | `page.routeFromHAR()`                     | High-fidelity mocks from recorded traffic          |
| Image blocking        | `page.route('**/*.{png,jpg}', abort)`     | Speed up tests by skipping images                  |
| CI sharding           | `--shard=1/4`                             | Split suite across parallel CI machines            |
| Blob reports          | `--reporter=blob` + `merge-reports`       | Merge sharded results into a single report         |
| Test tags             | `{ tag: ['@smoke'] }`                     | Filter tests by category with `--grep`             |
| Test steps            | `test.step('name', async () => {})`       | Group actions in trace viewer and reports          |
| Changed tests only    | `--only-changed=$GITHUB_BASE_REF`         | Run only test files changed since base branch      |
| Native a11y checks    | `toHaveAccessibleName`, `toHaveRole`      | Lightweight alternative to full axe-core scans     |
| Git info in reports   | `captureGitInfo` reporter option          | Link test reports to commits for CI debugging      |
| Web-first assertions  | `expect(element).toBeVisible()`           | Auto-wait instead of `waitForTimeout`              |
| Fixture composition   | `mergeTests()` / `mergeExpects()`         | Combine 3+ fixture modules into one `test`         |
| Auto fixtures         | `{ auto: true }` on `test.extend()`       | Run for every test (logging, screenshots)          |
| Fixture options       | `{ option: true }` on `test.extend()`     | Configurable via config or `test.use()`            |
| Data-driven tests     | `for...of` loop generating `test()` calls | Parameterized tests from arrays or CSV files       |
| Context emulation     | `browser.newContext()` options            | locale, timezone, colorScheme, offline, isMobile   |
| Two roles in one test | Concurrent `browser.newContext()` calls   | Separate storageState per context                  |

## Common Mistakes

| Mistake                                                  | Correct Pattern                                                                 |
| -------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Using `page.waitForTimeout()` for element visibility     | Use web-first assertions like `expect(element).toBeVisible()` which auto-wait   |
| Writing raw locators directly in test files              | Encapsulate all selectors in Page Object Model classes                          |
| Testing third-party APIs (Stripe, Auth0) directly        | Mock external services with `page.route()` for stable, fast tests               |
| Debugging CI failures with screenshots instead of traces | Configure `trace: 'on-first-retry'` and use Playwright Trace Viewer             |
| Sharing state between tests via global variables         | Use a fresh `BrowserContext` per test for full isolation                        |
| Running all tests in a single CI job                     | Use Playwright sharding (`--shard=1/N`) across parallel machines                |
| Using CSS/XPath selectors for element location           | Use role-based locators that survive refactors and enforce accessibility        |
| Logging in via UI in every test                          | Use `storageState` with setup projects to authenticate once                     |
| Using `injectAxe`/`checkA11y` from `axe-playwright`      | Use `AxeBuilder` from `@axe-core/playwright` with `.analyze()`                  |
| Committing `storageState` JSON files to git              | Add `playwright/.auth/` to `.gitignore`                                         |
| Relying on `storageState` for sign-out tests             | Sign-out invalidates server session — sign in via UI for each sign-out test     |
| Assuming `storageState` persists sessionStorage          | It only saves cookies + localStorage — use `addInitScript()` for sessionStorage |
| Duplicating test code for locale/currency variants       | Use fixture options (`{ option: true }`) with per-project config overrides      |
| Creating fixtures without `mergeTests()` for 3+ modules  | Use `mergeTests()` to compose fixture files into a single `test` export         |

## Delegation

- **Discover which user flows lack E2E coverage**: Use `Explore` agent
- **Build a full Page Object Model test suite for an application**: Use `Task` agent
- **Plan a CI sharding strategy for a large test suite**: Use `Plan` agent

> For Playwright API details, browser automation, scraping, stealth mode, screenshots/PDFs, Docker deployment, or troubleshooting Playwright errors, use the `playwright` skill.

## References

- [Role-based locators, auto-waiting, chaining, filtering, and locator strategy](references/locators.md)
- [Page Object Model architecture, fixtures integration, and base page patterns](references/page-objects.md)
- [Fixtures: scoping, composition, auto fixtures, options, and data-driven tests](references/fixtures.md)
- [Authentication with storageState, setup projects, and multi-role testing](references/authentication.md)
- [Network mocking, route interception, HAR replay, and WebSocket mocking](references/mocking.md)
- [Accessibility auditing with AxeBuilder, WCAG tags, and reusable fixtures](references/accessibility.md)
- [Visual regression, snapshot testing, masking, tolerance thresholds, and baseline management](references/visual-testing.md)
- [CI sharding, parallelism, blob reports, and browser caching](references/ci-sharding.md)
- [Test organization with tags, annotations, test.step, and project configuration](references/test-organization.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — e2e-testing от других авторов.

e2e-testing affaan-m Скилл e2e-testing для Claude Code содержит паттерны E2E-тестирования на Playwright: настройку Page Object Model, конфигов запуска и изоляцию нестабильных сценариев. CX Codex +1 7 200установок e2e-testing platform-team Скилл e2e-testing задаёт шаблоны E2E-тестирования на Playwright для веб-приложений на React и Python. Помогает строить надёжные сквозные сценарии и Page Objects. CX Codex +1 1 600установок testing-e2e OrchestKit Скилл testing-e2e задаёт правила E2E-тестов на Playwright: выбор семантических локаторов, Page Objects и проверки axe-core. Включается при работе с тестами и playwright.config.*. CX Codex +1 160установок appbuilder-e2e-testing adobe Скилл appbuilder-e2e-testing для Claude Code настраивает браузерные E2E-тесты Playwright для Adobe App Builder и расширений AEM. Проверяет SPA в ExC Shell и собирает сценарии для CI. CX Codex +1 835установок e2e-testing-automation aj-geddes Скилл e2e-testing-automation помогает писать end-to-end тесты: браузерные сценарии, проверка пользовательских путей и связки фронтенда с бэкендом. CX Codex +1 698установок playwright-e2e-testing fugazi Скилл playwright-e2e-testing для написания и поддержки E2E-тестов на Playwright с TypeScript: пользовательские сценарии, формы, авторизация, моки и визуальные сравнения. CX Codex +1 642установок playwright-e2e-testing-cursorrules-prompt-file PatrickJS Правило playwright-e2e-testing-cursorrules-prompt-file для Cursor, которое генерирует файлы тестов Playwright по описанию фичи: 3–5 сценариев для проверки ключевых пользовательских путей — входа, регистрации, оформления заказа. CX Codex +1 ★ 41 178звёзд репо e2e-playwright-testing Agent Skills Contributors Скилл e2e-playwright-testing для Claude Code помогает писать и проверять сквозные тесты в Playwright. Активируется при работе с браузерными сценариями, формами и файлами в tests/e2e/. CX Codex +1 880установок

Из того же набора106

Весь набор →
de-slopify Скилл de-slopify для Claude Code находит шаблонные обороты, лишние тире и следы ИИ в комментариях при правке текста и кода после языковой модели. CX Codex +1 146установок docker Скилл для сборки Docker-образов, настройки Compose-стеков и подготовки контейнеров к продакшену. CX Codex +1 145установок chrome-devtools Скилл chrome-devtools управляет настоящим Chrome через расширение или DevTools MCP: заполняет формы, читает страницы и помогает отлаживать веб-приложения. Работает с активной сессией браузера. CX Codex +1 145установок hydration-guardian Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок valkey Скилл помогает настраивать Valkey и Redis-совместимое хранилище: от кэша и лимитов запросов до очередей и миграции с Redis. Пригодится при проектировании схемы данных и Docker Compose. CX Codex +1 142установок remotion Скилл для Remotion: агент собирает видео из React-компонентов и держит анимацию в таймлайне, а не в CSS. CX Codex +1 141установок vite Описывает конфиг Vite, плагины, dev-сервер, сборку, SSR и переменные окружения. Задачи: правка vite.config.ts и сборка библиотек. CX Codex +1 138установок postgres-tuning Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой