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

ns-e2e-tests — скилл для Claude Code: E2E и установка

Скилл ns-e2e-tests задаёт структуру Cypress E2E-тестов, команд и сценариев для разных устройств. Нужен при создании и рефакторинге тестов.

Apache-2.0 151 установок обновлён 2026-10-24

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

Что делает ns-e2e-tests

ns-e2e-tests помогает вести Cypress E2E в отдельном проекте tests-e2e/ в корне репозитория. Сначала он ищет существующий cypress.config.ts, а при его отсутствии создаёт структуру с package.json, конфигурацией, скриптами cypress:open и cypress:run. baseUrl берётся из CYPRESS_BASE_URL, а спецификации лежат в cypress/e2e/**/*.cy.ts.

Команды раскладываются по shared/, pages/ и device/, затем регистрируются в cypress/support/e2e.ts. Сценарии разделяются на desktop, tablet и mobile; для них заданы viewports 1280×720, 768×1024 и 375×812. Скилл требует сначала изучить приложение, конфигурацию и уже существующие команды. Без подтверждённого {e2e_root} и читаемого cypress.config.ts он не переходит к созданию спецификаций. Сторонние HTTP/API-вызовы по умолчанию подменяются через intercepts или fixtures, а фиксированные cy.wait(N) запрещены.

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

  • создать отдельный Cypress-проект в tests-e2e/
  • разложить команды по общим, страничным и device-папкам
  • написать E2E-сценарии для desktop, tablet и mobile
  • перенести DOM-логику из спецификаций в команды
  • настроить подмену сторонних HTTP/API-вызовов

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

  • Создай Cypress E2E для нового пользовательского сценария и сначала проверь существующий cypress.config.ts.
  • Перепиши этот spec по архитектуре ns-e2e-tests: вынеси DOM-логику в команды и добавь device-папку.
  • Подготовь tests-e2e/ для проекта, если Cypress ещё не найден, затем добавь сценарии для mobile и desktop.

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

1Через Skills CLI (Vercel)

npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a claude-code

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

~/.claude/skills/ns-e2e-tests/SKILL.md

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

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

Вопросы о ns-e2e-tests

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

Выполните npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a claude-code, затем проверьте файл ~/.claude/skills/ns-e2e-tests/SKILL.md.

Что делает ns-e2e-tests?

Скилл помогает создавать и рефакторить Cypress E2E-тесты: находит или создаёт корень тестового проекта, организует команды и раскладывает спецификации по устройствам.

Какие платформы поддерживает ns-e2e-tests?

Скилл доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

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

SKILL.md · Apache-2.0
---
name: ns-e2e-tests
description: "(NS) Cypress E2E in independent tests-e2e/ at repo root (bootstrap when missing). DRY device-aware commands (shared/pages/device). Use when writing/refactoring Cypress specs, custom commands, scaffolding E2E, or implementing E2E tasks — not when planning E2E task markdown (ns-spec-driven references/e2e-test-task-generator.md). Mandatory discovery before specs."
license: Apache-2.0
metadata:
  author: nextstage-brasil
  version: "1.1"
---

# Create E2E Tests

Execution-phase Cypress implementation. Planning-phase: `ns-spec-driven/references/e2e-test-task-generator.md`.

## Session boot

Load `.nextstage-harness/rules/e2e-tests-rules.mdc` when present. See `references/e2e-architecture.md` for layout and bootstrap summary.

## Phase 0 — Resolve or bootstrap Cypress root

**Before any spec or command code**, locate the Cypress project or create it.

### 0.1 — Detect existing E2E (brownfield)

Search the repo in this order:

1. `tests-e2e/cypress.config.ts`
2. `testes-cypress/cypress.config.ts` (legacy name)
3. `frontend/cypress.config.ts` (legacy co-located)

Record the directory that contains `cypress.config.ts` as **`{e2e_root}`**. All paths below are relative to `{e2e_root}` unless noted.

### 0.2 — Bootstrap when nothing exists (greenfield)

If no match in 0.1, create **`tests-e2e/`** as a **standalone Node project**:

| Rule | Detail |
| ---- | ------ |
| Location | `tests-e2e/` only |
| `package.json` | **Here** — never add Cypress to `frontend/package.json` |
| Tree | Per `references/e2e-architecture.md` (config + empty `device/` folders + support imports) |
| `cypress.config.ts` | `baseUrl` from `CYPRESS_BASE_URL`; `specPattern` `cypress/e2e/**/*.cy.ts` |
| Scripts | `cypress:open`, `cypress:run` in `tests-e2e/package.json` |

Then set `{e2e_root} = tests-e2e/`.

**Forbidden on greenfield:** scaffolding under `frontend/cypress/`, copying deps into the frontend lockfile, or assuming Cypress is already installed in the app package.

### 0.3 — Post-bootstrap documentation

When `docs/context/stack-confirmed.md` or `architecture-rules.md` exists, add or update the E2E row: location `tests-e2e/`, run command `cd tests-e2e && npm run cypress:run` (or project docker equivalent).

Do not proceed to Phase 1 until `{e2e_root}` is confirmed and `cypress.config.ts` is readable.

## Phase 1 — Discovery (before feature code)

1. **App under test** — routes, forms, API usage, existing `data-testid` (read `frontend/`, not write Cypress there)
2. **Existing commands** — read all `{e2e_root}/cypress/support/commands/`; never duplicate
3. **Config** — `{e2e_root}/cypress.config.ts` baseUrl, env vars (`CYPRESS_BASE_URL`, `CYPRESS_API_URL`)

## Phase 2 — Command architecture first

```
{e2e_root}/cypress/support/commands/
  shared/[feature].commands.ts   # business actions — all devices
  pages/[feature].commands.ts    # page structure
  device/mobile|tablet|desktop.commands.ts
```

| Behavior            | Location  |
| ------------------- | --------- |
| Same on all devices | `shared/` |
| Device-exclusive    | `device/` |
| Page DOM structure  | `pages/`  |

Register new command files in `{e2e_root}/cypress/support/e2e.ts`.

Specs: `describe`/`it`, `cy.visit()`, commands, assertions — **no DOM logic in specs**.

## Phase 3 — Spec layout

```
{e2e_root}/cypress/e2e/device/
  desktop/[feature]/[feature]-successful-flows.cy.ts
  tablet/...
  mobile/...
```

Viewports in `beforeEach`:

- Desktop: 1280×720
- Tablet: 768×1024
- Mobile: 375×812

Forbidden: specs directly under `cypress/e2e/` without `device/` prefix.

## Phase 4 — Implement

- Use `data-testid` from frontend task contract — do not invent
- No fixed `cy.wait(N)` — intercepts or assertion timeouts
- Third-party HTTP/API calls **stubbed by default** (intercepts/fixtures). Real third-party flows → opt-in project/tag (live tier); exclude from default `cypress:run` / CI unless human asks
- RBAC: menu hidden + direct URL denial
- Auth: login via UI or support session; tenant-aware fixtures

## Phase 5 — Run and report

From `{e2e_root}`: `npm run cypress:run` (or docker equivalent documented for the product). Report failures with `ns-investigator` if needed.

**SDD version execution:** when called under `execution-handoff.md` /
`run-implementation`, **write or refactor specs only** — do **not** run the E2E
suite. The human runs E2E at version end.

## References

| File                             | When                              |
| -------------------------------- | --------------------------------- |
| `references/e2e-architecture.md` | Root layout, bootstrap tree, rules |
| `../ns-spec-driven/references/e2e-test-task-generator.md` | Task contract source |

## Related skills

- `ns-spec-driven` `references/e2e-test-task-generator.md` — planning tasks with testid contract
- `ns-investigator` — failing E2E debugging
- `ns-gitlab-ci-generator` — CI `cd tests-e2e` and change paths

© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills

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

Все скиллы по теме «Тесты и QA» →
e2e-tests-studio mastra-ai Скилл e2e-tests-studio автоматически генерирует Playwright E2E тесты при изменении компонентов playground. Тестирует не состояние интерфейса, а реальное поведение: сохранение данных, потоки данных, эффекты действий. CX Codex +1 2 500установок e2e-test-builder patricio0312rev Скилл e2e-test-builder генерирует сквозные браузерные тесты для Playwright и Cypress с паттерном Page Object, фикстурами и селекторами по ролям. CX Codex +1 273установок e2e-setup davila7 Команда e2e-setup разворачивает сквозное E2E-тестирование в проекте, подбирает фреймворк и настраивает запуск тестов в CI. CX Codex +1 477установок adding-e2e-tests spencerpauly Скилл adding-e2e-tests проводит агента по шагам настройки Playwright: конфиг, смоук-тест, npm-скрипты и запуск в CI. CX Codex +1 486установок om-integration-tests open-mercato Скилл om-integration-tests помогает создавать и отлаживать E2E-тесты в живом приложении без угадывания селекторов. Исследует запущенный сервис через настроенный браузер и сохраняет привычный тестовый раннер репозитория. CX Codex +1 3 800установок write-e2e-tests tldraw Скилл write-e2e-tests помогает писать Playwright E2E-тесты для tldraw: действия в интерфейсе, меню и фигуры на холсте. Нужен при добавлении тестов в примеры SDK или клиент tldraw.com. CX Codex +1 437установок

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

Весь набор →
ns-best-practices Скилл ns-best-practices проверяет заголовки безопасности, базовую доступность интерфейса и правила Web Interface Guidelines. Находит уязвимости и готовит отчёт. CX Codex +1 154установок ns-investigator Скилл ns-investigator для Claude Code анализирует стек-трейсы, логи и упавшие тесты, находит корневую причину и предлагает минимальный фикс без реализации. CX Codex +1 153установок ns-frontend-design Скилл ns-frontend-design для Claude Code, Codex, Cursor и других агентов — строит production-интерфейсы с типографикой, иерархией и анимацией. Срабатывает на страницах, компонентах, дашбордах, формах и KPI-аналитике. CX Codex +1 153установок ns-autonomous Скилл ns-autonomous для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который берёт локальный план или произвольный текст и выполняет его автономно в изолированном worktree. CX Codex +1 152установок ns-backend-tests Скилл ns-backend-tests для написания и запуска unit- и интеграционных тестов PHPUnit прямо в IDE. Работает только в Docker-контейнере, помогает быстро покрыть тестами новый Laravel-проект или переписать существующие тесты. CX Codex +1 151установок ns-docs-writer Скилл ns-docs-writer для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который пишет человекочитаемую документацию проекта: README, руководства в docs/, ранбуки и инструкции для контрибьюторов. CX Codex +1 151установок ns-coder Скилл ns-coder реализует небольшие изменения в коде: исправления, рефакторинг, скрипты и миграции. Он пригодится для разовой задачи вне многоэтапной разработки по SDD. CX Codex +1 151установок ns-reviewer Скилл ns-reviewer проверяет качество кода перед PR: оценивает SOLID, чистоту кода, производительность, безопасность и тестируемость. Одобрит только при оценке 10, оценка 9 означает отклонение. CX Codex +1 140установок

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

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