cypress-skill — скилл для Claude Code: E2E-тесты на Cypress
Генерирует production-grade E2E и component-тесты на JavaScript или TypeScript. Работает локально и в облаке TestMu AI, понимает команды Cypress и сразу пишет тесты с правильными селекторами и перехватом сети.
MIT 264 установок ★ 393 обновлён 2026-10-13
npx skills add LambdaTest/agent-skills --skill cypress-skill -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/cypress-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cypress-skill/
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill cypress-skill -a codex2Вручную: положить файлы
.agents/skills/cypress-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill cypress-skill -a cursor2Вручную: положить файлы
.cursor/skills/cypress-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills cypress-skill2Вручную: положить файлы
.github/skills/cypress-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill cypress-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/LambdaTest/agent-skills --path cypress-skillВручную: положить файлы
.devin/skills/cypress-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill cypress-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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