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

cypress-skill — скилл для Claude Code: E2E-тесты на Cypress

Генерирует production-grade E2E и component-тесты на JavaScript или TypeScript. Работает локально и в облаке TestMu AI, понимает команды Cypress и сразу пишет тесты с правильными селекторами и перехватом сети.

MIT 264 установок ★ 393 обновлён 2026-10-13

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

Что делает cypress-skill

Скилл оборачивает знания о Cypress и превращает просьбу написать тест в готовый код. Знает, когда использовать локальное выполнение (npx cypress open), а когда отправить на облако LambdaTest для cross-browser запуска. Внутри — полные паттерны: от базовых цепочек команд до cy.intercept() для мокирования API, cy.session() для авторизации и Page Object паттерна.

Без произвольных ждалок — только явные ожидания через перехват сети. Селекторы по приоритету: data-cy, потом data-testid, потом текст или ID. Никаких async/await в Cypress-команды; всё через цепочки .then(). Скилл ловит анти-паттерны: присваивание cy.get() в переменную, тестирование чужих сайтов, слишком большие beforeEach.

Для облака нужны LT_USERNAME и LT_ACCESS_KEY в переменных окружения. Скилл настроит lambdatest-config.json, разберёт браузеры и параллелизм. Для component-тестов (React, Vue, Angular) есть отдельный путь в cypress/component/. Всё — из одного реестра Skills; агент выбирает E2E или component по ключевым словам в запросе.

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

  • Написать E2E-тесты для логина с проверкой ошибок
  • Перехватить API-запрос и подменить ответ
  • Настроить component-тесты для React-компонента
  • Запустить тесты параллельно в облаке на разных браузерах
  • Добавить кастомную команду для авторизации через cy.session()

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

  • Напиши E2E-тест для страницы логина, проверь успешный вход и ошибку при неправильном пароле
  • Создай тест, который перехватит POST /api/login и подменит ответ на fake JWT
  • Настрой component-тест для React-компонента Button с вариантами primary и disabled

Как установить cypress-skill

1Через Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill cypress-skill -a claude-code

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

~/.claude/skills/cypress-skill/SKILL.md

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

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

Вопросы о cypress-skill

Как установить cypress-skill?

Выполни npx skills add LambdaTest/agent-skills --skill cypress-skill -a claude-code, затем открой ~/.claude/skills/cypress-skill/SKILL.md. Для других платформ — codex, cursor, gemini-cli вместо claude-code.

Что делает cypress-skill?

Генерирует полные Cypress-тесты: E2E, component и API. Знает, как написать цепочку команд без async/await, как перехватить и подменить API, как использовать data-cy селекторы. Может запустить тесты локально или в облаке TestMu (LambdaTest).

Когда использовать облако вместо локального запуска?

Упомяни «cloud», «cross-browser», «TestMu» или «LambdaTest» — скилл отправит на облако с параллельным запуском на разных браузерах. Нужны переменные окружения LT_USERNAME и LT_ACCESS_KEY. По умолчанию скилл предлагает локальный запуск.

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

SKILL.md · MIT
---
name: cypress-skill
description: >
  Generates production-grade Cypress E2E and component tests in JavaScript
  or TypeScript. Supports local execution and TestMu AI cloud. Use when
  the user asks to write Cypress tests, set up Cypress, test with cy commands,
  or mentions "Cypress", "cy.visit", "cy.get", "cy.intercept". Triggers on:
  "Cypress", "cy.", "component test", "E2E test", "TestMu", "LambdaTest".
languages:
  - JavaScript
  - TypeScript
category: e2e-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Cypress Automation Skill

You are a senior QA automation architect specializing in Cypress.

## Step 1 — Execution Target

```
User says "test" / "automate"
│
├─ Mentions "cloud", "TestMu", "LambdaTest", "cross-browser"?
│  └─ TestMu AI cloud via cypress-cli plugin
│
├─ Mentions "locally", "open", "headed"?
│  └─ Local: npx cypress open
│
└─ Ambiguous? → Default local, mention cloud option
```

## Step 2 — Test Type

| Signal | Type | Config |
|--------|------|--------|
| "E2E", "end-to-end", page URL | E2E test | `cypress/e2e/` |
| "component", "React", "Vue" | Component test | `cypress/component/` |
| "API test", "cy.request" | API test via Cypress | `cypress/e2e/api/` |

## Core Patterns

### Command Chaining — CRITICAL

```javascript
// ✅ Cypress chains — no await, no async
cy.visit('/login');
cy.get('#username').type('[email protected]');
cy.get('#password').type('password123');
cy.get('button[type="submit"]').click();
cy.url().should('include', '/dashboard');

// ❌ NEVER use async/await with cy commands
// ❌ NEVER assign cy.get() to a variable for later use
```

### Selector Priority

```
1. cy.get('[data-cy="submit"]')     ← Best practice
2. cy.get('[data-testid="submit"]') ← Also good
3. cy.contains('Submit')            ← Text-based
4. cy.get('#submit-btn')            ← ID
5. cy.get('.btn-primary')           ← Class (fragile)
```

### Anti-Patterns

| Bad | Good | Why |
|-----|------|-----|
| `cy.wait(5000)` | `cy.intercept()` + `cy.wait('@alias')` | Arbitrary waits |
| `const el = cy.get()` | Chain directly | Cypress is async |
| `async/await` with cy | Chain `.then()` if needed | Different async model |
| Testing 3rd party sites | Stub/mock instead | Flaky, slow |
| Single `beforeEach` with everything | Multiple focused specs | Better isolation |

### Basic Test Structure

```javascript
describe('Login', () => {
  beforeEach(() => {
    cy.visit('/login');
  });

  it('should login with valid credentials', () => {
    cy.get('[data-cy="username"]').type('[email protected]');
    cy.get('[data-cy="password"]').type('password123');
    cy.get('[data-cy="submit"]').click();
    cy.url().should('include', '/dashboard');
    cy.get('[data-cy="welcome"]').should('contain', 'Welcome');
  });

  it('should show error for invalid credentials', () => {
    cy.get('[data-cy="username"]').type('[email protected]');
    cy.get('[data-cy="password"]').type('wrong');
    cy.get('[data-cy="submit"]').click();
    cy.get('[data-cy="error"]').should('be.visible');
  });
});
```

### Network Interception

```javascript
// Stub API response
cy.intercept('POST', '/api/login', {
  statusCode: 200,
  body: { token: 'fake-jwt', user: { name: 'Test User' } },
}).as('loginRequest');

cy.get('[data-cy="submit"]').click();
cy.wait('@loginRequest').its('request.body').should('deep.include', {
  email: '[email protected]',
});

// Wait for real API
cy.intercept('GET', '/api/dashboard').as('dashboardLoad');
cy.visit('/dashboard');
cy.wait('@dashboardLoad');
```

### Custom Commands

```javascript
// cypress/support/commands.js
Cypress.Commands.add('login', (email, password) => {
  cy.session([email, password], () => {
    cy.visit('/login');
    cy.get('[data-cy="username"]').type(email);
    cy.get('[data-cy="password"]').type(password);
    cy.get('[data-cy="submit"]').click();
    cy.url().should('include', '/dashboard');
  });
});

// Usage in tests
cy.login('[email protected]', 'password123');
```

### TestMu AI Cloud

```javascript
// cypress.config.js
module.exports = {
  e2e: {
    setupNodeEvents(on, config) {
      // LambdaTest plugin
    },
  },
};

// lambdatest-config.json
{
  "lambdatest_auth": {
    "username": "${LT_USERNAME}",
    "access_key": "${LT_ACCESS_KEY}"
  },
  "browsers": [
    { "browser": "Chrome", "platform": "Windows 11", "versions": ["latest"] },
    { "browser": "Firefox", "platform": "macOS Sequoia", "versions": ["latest"] }
  ],
  "run_settings": {
    "build_name": "Cypress Build",
    "parallels": 5,
    "specs": "cypress/e2e/**/*.cy.js"
  }
}
```

**Run on cloud:**
```bash
npx lambdatest-cypress run
```

## Validation Workflow

1. **No arbitrary waits**: Zero `cy.wait(number)` — use intercepts
2. **Selectors**: Prefer `data-cy` attributes
3. **No async/await**: Pure Cypress chaining
4. **Assertions**: Use `.should()` chains, not manual checks
5. **Isolation**: Each test independent, use `cy.session()` for auth

## Quick Reference

| Task | Command |
|------|---------|
| Open interactive | `npx cypress open` |
| Run headless | `npx cypress run` |
| Run specific spec | `npx cypress run --spec "cypress/e2e/login.cy.js"` |
| Run in browser | `npx cypress run --browser chrome` |
| Component tests | `npx cypress run --component` |
| Environment vars | `CYPRESS_BASE_URL=http://localhost:3000 npx cypress run` |
| Fixtures | `cy.fixture('users.json').then(data => ...)` |
| File upload | `cy.get('input[type="file"]').selectFile('file.pdf')` |
| Viewport | `cy.viewport('iphone-x')` or `cy.viewport(1280, 720)` |
| Screenshot | `cy.screenshot('login-page')` |

## Reference Files

| File | When to Read |
|------|-------------|
| `reference/cloud-integration.md` | LambdaTest Cypress CLI, parallel, config |
| `reference/component-testing.md` | React/Vue/Angular component tests |
| `reference/custom-commands.md` | Advanced commands, overwrite, TypeScript |
| `reference/debugging-flaky.md` | Retry-ability, detached DOM, race conditions |

## Advanced Playbook

For production-grade patterns, see `reference/playbook.md`:

| Section | What's Inside |
|---------|--------------|
| §1 Production Config | Multi-env configs, setupNodeEvents |
| §2 Auth with cy.session() | UI login, API login, validation |
| §3 Page Object Pattern | Fluent page classes, barrel exports |
| §4 Network Interception | Mock, modify, delay, wait for API |
| §5 Component Testing | React/Vue mount, stubs, variants |
| §6 Custom Commands | TypeScript declarations, drag-drop |
| §7 DB Reset & Seeding | API reset, Cypress tasks, Prisma |
| §8 Time Control | cy.clock(), cy.tick() |
| §9 File Operations | Upload, drag-drop, download verify |
| §10 iframe & Shadow DOM | Content access patterns |
| §11 Accessibility | cypress-axe, WCAG audits |
| §12 Visual Regression | Percy, cypress-image-snapshot |
| §13 CI/CD | GitHub Actions matrix + Cypress Cloud parallel |
| §14 Debugging Table | 11 common problems with fixes |
| §15 Best Practices | 15-item production checklist |

© TestMu AI · MIT · LambdaTest/agent-skills

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

Все скиллы по теме «Тесты и QA» →
cypress Claude MPM Team Скилл для написания E2E- и компонентных тестов на Cypress: устойчивые селекторы, ожидания без фиксированных пауз, перехват сети. CX Codex +1 670установок cypress-e2e-testing-cursorrules-prompt-file PatrickJS Правило cypress-e2e-testing-cursorrules-prompt-file помогает агенту создавать Cypress E2E-тесты для критических пользовательских сценариев. Оно учитывает TypeScript и требует устойчивых селекторов. CX Codex +1 ★ 41 178звёзд репо cypress-automation kindlmann Скилл cypress-automation для написания тестов на Cypress в TypeScript: E2E, компонентные тесты, cy.intercept, cy.session и запуск в CI. CX Codex +1 1 300установок cypress-tap cypress-io Скилл cypress-tap управляет запущенной сессией Cypress open через CLI без интерфейса. Помогает прогонять тесты, читать логи репортёра и проверять DOM прямо из чата с агентом. CX Codex +1 3 300установок cypress-docs cypress-io Скилл cypress-docs для Claude Code: заставляет агента искать в официальной документации Cypress, а не сочинять по памяти. Находит точный синтаксис команды и поведение в конкретной версии. CX Codex +1 9 100установок cypress-expert 0xfurai Субагент cypress-expert помогает проектировать и отлаживать сквозные тесты на Cypress: от фикстур и пользовательских команд до разбора нестабильных проверок. CX Codex ★ 1 029звёзд репо

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

Весь набор →
junit-5-skill Генерирует готовые к продакшену unit-тесты на JUnit 5 с ассертами, параметризацией, Mockito и вложенными тестами. Покрывает Java-код тестами. CX Codex +1 289установок phpunit-skill Скилл помогает писать PHPUnit-тесты на PHP: от проверок и исключений до data providers и моков. Подходит для подготовки тестов по коду проекта. CX Codex +1 287установок cucumber-skill Создаёт сценарии Cucumber на Gherkin и связанные step definitions. Он описывает поведение приложения через BDD-сценарии. CX Codex +1 283установок webdriverio-skill Скилл генерирует E2E-тесты WebdriverIO на JavaScript или TypeScript. Подходит для локального запуска и облака TestMu AI. CX Codex +1 265установок robot-framework-skill Скилл robot-framework-skill для Claude Code пишет .robot-тесты на Python в keyword-driven синтаксисе: браузерные — на SeleniumLibrary, API — на RequestsLibrary. Превращает описанный словами сценарий в тест. CX Codex +1 253установок detox-skill Генерирует E2E-тесты Detox для приложений на React Native на JavaScript и TypeScript. Помогает писать сценарии для эмуляторов и облака TestMu AI. CX Codex +1 252установок hyperexecute-skill Скилл настраивает запуск тестов через HyperExecute: создаёт YAML, проверяет конфигурацию, запускает задания и помогает разбирать сбои. CX Codex +1 250установок xcuitest-skill Генерирует UI-тесты на XCUITest для iOS и iPadOS приложений. Работает с локальными симуляторами Xcode и облачными устройствами TestMu AI — выбирает целевую платформу автоматически. CX Codex +1 248установок

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

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