ns-e2e-tests — скилл для Claude Code: E2E и установка
Скилл ns-e2e-tests задаёт структуру Cypress E2E-тестов, команд и сценариев для разных устройств. Нужен при создании и рефакторинге тестов.
Apache-2.0 151 установок обновлён 2026-10-24
npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/ns-e2e-tests/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ns-e2e-tests/
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a codex2Вручную: положить файлы
.agents/skills/ns-e2e-tests/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a cursor2Вручную: положить файлы
.cursor/skills/ns-e2e-tests/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nextstage-brasil/skills skills/ns-e2e-tests2Вручную: положить файлы
.github/skills/ns-e2e-tests/SKILL.md1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a gemini-cli2Командой платформы
gemini skills install https://github.com/nextstage-brasil/skills --path skills/ns-e2e-testsВручную: положить файлы
.devin/skills/ns-e2e-tests/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-e2e-tests -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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