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

cypress-playwright-setup — скилл для Claude Code

Скилл cypress-playwright-setup для Claude Code, Codex, Cursor и других агентов, который разворачивает E2E-тестирование на Cypress или Playwright: page objects, фикстуры и CI-интеграция.

MIT 313 установок ★ 64 обновлён 2026-01-12

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

Что делает cypress-playwright-setup

Агент проходит фиксированный сценарий: выбирает Cypress или Playwright, создаёт конфиг браузеров и тестовой директории, генерирует базовые и конкретные page objects с селекторами, пишет тесты для пользовательских сценариев, добавляет фикстуры для тестовых данных и подключает CI-шаг.

Для Playwright скилл создаёт playwright.config.ts с параллельным запуском, тремя desktop-браузерами (Chromium, Firefox, WebKit) и двумя мобильными профилями (Pixel 5 и iPhone 12), HTML/JSON/JUnit-репортерами и автоматическим подъёмом dev-сервера через webServer. В CI включаются ретраи и одиночный воркер. Page objects строятся на классе BasePage с наследованием: LoginPage и DashboardPage уже готовы с ролевыми и label-селекторами. Фикстуры расширяют базовый тест и хранят логику аутентификации отдельно от тестов.

Базовый URL берётся из переменной окружения BASE_URL, по умолчанию — http://localhost:3000. Без запущенного приложения на этом адресе тесты не пройдут.

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

  • Настроить Playwright с мультибраузерным запуском за один шаг
  • Сгенерировать page objects с ролевыми и label-селекторами
  • Подключить CI-шаг с ретраями и JUnit-репортером
  • Отделить логику аутентификации в фикстуры Playwright
  • Развернуть структуру E2E-тестов в новом проекте

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

  • Настрой E2E-тестирование через Playwright с page objects и CI
  • Создай фикстуры для авторизации в Playwright-тестах
  • Подключи Cypress к проекту с базовыми тестами и конфигом

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

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill cypress-playwright-setup -a claude-code

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

~/.claude/skills/cypress-playwright-setup/SKILL.md

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

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

Вопросы о cypress-playwright-setup

Как установить cypress-playwright-setup в Claude Code?

Выполните npx skills add patricio0312rev/skills --skill cypress-playwright-setup -a claude-code. Скилл появится в ~/.claude/skills/cypress-playwright-setup/SKILL.md.

Что делает скилл cypress-playwright-setup?

Разворачивает полную структуру E2E-тестирования: конфиг Playwright или Cypress, page objects с базовым классом, фикстуры для тестовых данных и CI-интеграцию с репортерами.

На каких платформах работает cypress-playwright-setup?

Скилл поддерживает Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Команда установки отличается для каждой платформы, поэтому используйте флаг -a с нужным агентом.

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

SKILL.md · MIT
---
name: cypress-playwright-setup
description: Sets up end-to-end testing with Cypress or Playwright including page objects, fixtures, and CI integration. Use when users request "E2E testing", "Cypress setup", "Playwright setup", "browser testing", or "integration tests".
---

# Cypress & Playwright Setup

Configure comprehensive end-to-end testing for web applications.

## Core Workflow

1. **Choose tool**: Cypress or Playwright
2. **Configure project**: Browser and test settings
3. **Create page objects**: Reusable selectors
4. **Write tests**: User journey coverage
5. **Setup fixtures**: Test data
6. **Integrate CI**: Automated testing

## Playwright Setup

### Installation

```bash
npm init playwright@latest
```

### Configuration

```typescript
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  testDir: './e2e',
  fullyParallel: true,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  workers: process.env.CI ? 1 : undefined,
  reporter: [
    ['html'],
    ['json', { outputFile: 'test-results/results.json' }],
    ['junit', { outputFile: 'test-results/junit.xml' }],
  ],

  use: {
    baseURL: process.env.BASE_URL || 'http://localhost:3000',
    trace: 'on-first-retry',
    screenshot: 'only-on-failure',
    video: 'retain-on-failure',
  },

  projects: [
    {
      name: 'chromium',
      use: { ...devices['Desktop Chrome'] },
    },
    {
      name: 'firefox',
      use: { ...devices['Desktop Firefox'] },
    },
    {
      name: 'webkit',
      use: { ...devices['Desktop Safari'] },
    },
    {
      name: 'Mobile Chrome',
      use: { ...devices['Pixel 5'] },
    },
    {
      name: 'Mobile Safari',
      use: { ...devices['iPhone 12'] },
    },
  ],

  webServer: {
    command: 'npm run start',
    url: 'http://localhost:3000',
    reuseExistingServer: !process.env.CI,
    timeout: 120 * 1000,
  },
});
```

### Page Object Model

```typescript
// e2e/pages/BasePage.ts
import { Page, Locator } from '@playwright/test';

export abstract class BasePage {
  readonly page: Page;

  constructor(page: Page) {
    this.page = page;
  }

  async goto(path: string = '') {
    await this.page.goto(path);
  }

  async waitForLoad() {
    await this.page.waitForLoadState('networkidle');
  }

  getByTestId(testId: string): Locator {
    return this.page.getByTestId(testId);
  }
}
```

```typescript
// e2e/pages/LoginPage.ts
import { Page, Locator, expect } from '@playwright/test';
import { BasePage } from './BasePage';

export class LoginPage extends BasePage {
  readonly emailInput: Locator;
  readonly passwordInput: Locator;
  readonly submitButton: Locator;
  readonly errorMessage: Locator;
  readonly forgotPasswordLink: Locator;

  constructor(page: Page) {
    super(page);
    this.emailInput = page.getByLabel('Email');
    this.passwordInput = page.getByLabel('Password');
    this.submitButton = page.getByRole('button', { name: 'Sign in' });
    this.errorMessage = page.getByTestId('error-message');
    this.forgotPasswordLink = page.getByRole('link', { name: 'Forgot password?' });
  }

  async goto() {
    await super.goto('/login');
    await this.waitForLoad();
  }

  async login(email: string, password: string) {
    await this.emailInput.fill(email);
    await this.passwordInput.fill(password);
    await this.submitButton.click();
  }

  async expectError(message: string) {
    await expect(this.errorMessage).toBeVisible();
    await expect(this.errorMessage).toContainText(message);
  }

  async expectLoginSuccess() {
    await expect(this.page).toHaveURL(/\/dashboard/);
  }
}
```

```typescript
// e2e/pages/DashboardPage.ts
import { Page, Locator, expect } from '@playwright/test';
import { BasePage } from './BasePage';

export class DashboardPage extends BasePage {
  readonly welcomeMessage: Locator;
  readonly userMenu: Locator;
  readonly logoutButton: Locator;
  readonly sidebar: Locator;

  constructor(page: Page) {
    super(page);
    this.welcomeMessage = page.getByTestId('welcome-message');
    this.userMenu = page.getByTestId('user-menu');
    this.logoutButton = page.getByRole('button', { name: 'Logout' });
    this.sidebar = page.getByTestId('sidebar');
  }

  async goto() {
    await super.goto('/dashboard');
    await this.waitForLoad();
  }

  async logout() {
    await this.userMenu.click();
    await this.logoutButton.click();
    await expect(this.page).toHaveURL('/login');
  }

  async expectWelcome(name: string) {
    await expect(this.welcomeMessage).toContainText(`Welcome, ${name}`);
  }
}
```

### Test Examples

```typescript
// e2e/auth.spec.ts
import { test, expect } from '@playwright/test';
import { LoginPage } from './pages/LoginPage';
import { DashboardPage } from './pages/DashboardPage';

test.describe('Authentication', () => {
  let loginPage: LoginPage;

  test.beforeEach(async ({ page }) => {
    loginPage = new LoginPage(page);
    await loginPage.goto();
  });

  test('successful login', async ({ page }) => {
    await loginPage.login('[email protected]', 'password123');
    await loginPage.expectLoginSuccess();

    const dashboard = new DashboardPage(page);
    await dashboard.expectWelcome('Test User');
  });

  test('invalid credentials', async () => {
    await loginPage.login('[email protected]', 'wrongpassword');
    await loginPage.expectError('Invalid email or password');
  });

  test('empty fields validation', async () => {
    await loginPage.submitButton.click();
    await expect(loginPage.page.getByText('Email is required')).toBeVisible();
    await expect(loginPage.page.getByText('Password is required')).toBeVisible();
  });

  test('forgot password flow', async ({ page }) => {
    await loginPage.forgotPasswordLink.click();
    await expect(page).toHaveURL('/forgot-password');
  });
});
```

### Fixtures

```typescript
// e2e/fixtures/auth.fixture.ts
import { test as base, expect } from '@playwright/test';
import { LoginPage } from '../pages/LoginPage';
import { DashboardPage } from '../pages/DashboardPage';

interface AuthFixtures {
  loginPage: LoginPage;
  dashboardPage: DashboardPage;
  authenticatedPage: DashboardPage;
}

export const test = base.extend<AuthFixtures>({
  loginPage: async ({ page }, use) => {
    const loginPage = new LoginPage(page);
    await use(loginPage);
  },

  dashboardPage: async ({ page }, use) => {
    const dashboardPage = new DashboardPage(page);
    await use(dashboardPage);
  },

  authenticatedPage: async ({ page }, use) => {
    // Login before test
    const loginPage = new LoginPage(page);
    await loginPage.goto();
    await loginPage.login('[email protected]', 'password123');
    await loginPage.expectLoginSuccess();

    const dashboardPage = new DashboardPage(page);
    await use(dashboardPage);
  },
});

export { expect };
```

```typescript
// e2e/dashboard.spec.ts
import { test, expect } from './fixtures/auth.fixture';

test.describe('Dashboard', () => {
  test('shows user data', async ({ authenticatedPage }) => {
    await authenticatedPage.expectWelcome('Test User');
  });

  test('logout redirects to login', async ({ authenticatedPage }) => {
    await authenticatedPage.logout();
  });
});
```

## Cypress Setup

### Installation

```bash
npm install -D cypress @testing-library/cypress
npx cypress open
```

### Configuration

```typescript
// cypress.config.ts
import { defineConfig } from 'cypress';

export default defineConfig({
  e2e: {
    baseUrl: 'http://localhost:3000',
    viewportWidth: 1280,
    viewportHeight: 720,
    video: true,
    screenshotOnRunFailure: true,
    retries: {
      runMode: 2,
      openMode: 0,
    },
    experimentalStudio: true,
    setupNodeEvents(on, config) {
      // Tasks and plugins
    },
  },

  component: {
    devServer: {
      framework: 'react',
      bundler: 'vite',
    },
  },
});
```

### Support Commands

```typescript
// cypress/support/commands.ts
import '@testing-library/cypress/add-commands';

declare global {
  namespace Cypress {
    interface Chainable {
      login(email: string, password: string): Chainable<void>;
      getByTestId(testId: string): Chainable<JQuery<HTMLElement>>;
      mockApi(fixture: string): Chainable<void>;
    }
  }
}

Cypress.Commands.add('login', (email: string, password: string) => {
  cy.session([email, password], () => {
    cy.visit('/login');
    cy.get('[data-testid="email-input"]').type(email);
    cy.get('[data-testid="password-input"]').type(password);
    cy.get('[data-testid="submit-button"]').click();
    cy.url().should('include', '/dashboard');
  });
});

Cypress.Commands.add('getByTestId', (testId: string) => {
  return cy.get(`[data-testid="${testId}"]`);
});

Cypress.Commands.add('mockApi', (fixture: string) => {
  cy.intercept('GET', '/api/**', { fixture }).as('apiCall');
});
```

### Cypress Tests

```typescript
// cypress/e2e/auth.cy.ts
describe('Authentication', () => {
  beforeEach(() => {
    cy.visit('/login');
  });

  it('logs in successfully', () => {
    cy.get('[data-testid="email-input"]').type('[email protected]');
    cy.get('[data-testid="password-input"]').type('password123');
    cy.get('[data-testid="submit-button"]').click();

    cy.url().should('include', '/dashboard');
    cy.getByTestId('welcome-message').should('contain', 'Welcome');
  });

  it('shows error for invalid credentials', () => {
    cy.get('[data-testid="email-input"]').type('[email protected]');
    cy.get('[data-testid="password-input"]').type('wrongpassword');
    cy.get('[data-testid="submit-button"]').click();

    cy.getByTestId('error-message').should('be.visible');
    cy.url().should('include', '/login');
  });

  it('validates required fields', () => {
    cy.get('[data-testid="submit-button"]').click();
    cy.contains('Email is required').should('be.visible');
    cy.contains('Password is required').should('be.visible');
  });
});
```

### API Mocking in Cypress

```typescript
// cypress/e2e/products.cy.ts
describe('Products', () => {
  beforeEach(() => {
    cy.login('[email protected]', 'password123');
  });

  it('displays products from API', () => {
    cy.intercept('GET', '/api/products', {
      fixture: 'products.json',
    }).as('getProducts');

    cy.visit('/products');
    cy.wait('@getProducts');

    cy.getByTestId('product-card').should('have.length', 3);
  });

  it('handles API error gracefully', () => {
    cy.intercept('GET', '/api/products', {
      statusCode: 500,
      body: { error: 'Server Error' },
    }).as('getProductsError');

    cy.visit('/products');
    cy.wait('@getProductsError');

    cy.getByTestId('error-message').should('contain', 'Failed to load products');
  });

  it('filters products', () => {
    cy.intercept('GET', '/api/products?category=electronics', {
      fixture: 'products-electronics.json',
    }).as('getElectronics');

    cy.visit('/products');
    cy.getByTestId('category-filter').select('electronics');

    cy.wait('@getElectronics');
    cy.getByTestId('product-card').should('have.length', 2);
  });
});
```

## CI Integration

### GitHub Actions

```yaml
# .github/workflows/e2e.yml
name: E2E Tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  playwright:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'

      - run: npm ci

      - name: Install Playwright Browsers
        run: npx playwright install --with-deps

      - name: Build
        run: npm run build

      - name: Run Playwright tests
        run: npx playwright test
        env:
          CI: true

      - uses: actions/upload-artifact@v4
        if: always()
        with:
          name: playwright-report
          path: playwright-report/
          retention-days: 30

  cypress:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'

      - run: npm ci

      - name: Cypress run
        uses: cypress-io/github-action@v6
        with:
          build: npm run build
          start: npm start
          wait-on: 'http://localhost:3000'
          browser: chrome
          record: true
        env:
          CYPRESS_RECORD_KEY: ${{ secrets.CYPRESS_RECORD_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - uses: actions/upload-artifact@v4
        if: failure()
        with:
          name: cypress-screenshots
          path: cypress/screenshots
```

## Accessibility Testing

```typescript
// e2e/accessibility.spec.ts (Playwright)
import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';

test.describe('Accessibility', () => {
  test('homepage has no accessibility violations', async ({ page }) => {
    await page.goto('/');

    const accessibilityScanResults = await new AxeBuilder({ page }).analyze();

    expect(accessibilityScanResults.violations).toEqual([]);
  });

  test('login page has no accessibility violations', async ({ page }) => {
    await page.goto('/login');

    const accessibilityScanResults = await new AxeBuilder({ page })
      .withTags(['wcag2a', 'wcag2aa'])
      .analyze();

    expect(accessibilityScanResults.violations).toEqual([]);
  });
});
```

```typescript
// cypress/e2e/accessibility.cy.ts
import 'cypress-axe';

describe('Accessibility', () => {
  beforeEach(() => {
    cy.injectAxe();
  });

  it('homepage has no accessibility violations', () => {
    cy.visit('/');
    cy.checkA11y();
  });

  it('login form is accessible', () => {
    cy.visit('/login');
    cy.checkA11y('[data-testid="login-form"]');
  });
});
```

## Best Practices

1. **Use page objects**: Maintainable selectors
2. **Use test IDs**: Stable element selection
3. **Avoid sleep**: Use proper waits
4. **Isolate tests**: No dependencies between tests
5. **Mock external APIs**: Reliable, fast tests
6. **Test accessibility**: Include a11y checks
7. **Parallel execution**: Faster CI
8. **Meaningful assertions**: Clear expectations

## Output Checklist

Every E2E setup should include:

- [ ] Playwright/Cypress configuration
- [ ] Page object model
- [ ] Custom commands/fixtures
- [ ] API mocking setup
- [ ] Authentication handling
- [ ] Multi-browser testing
- [ ] Accessibility tests
- [ ] CI integration
- [ ] Reporting configuration
- [ ] Screenshot/video on failure

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «Тесты и QA» →
playwright-pro borghei Скилл playwright-pro для Claude Code, Codex и Cursor. Генерирует E2E-тесты на Playwright, настраивает Page Object, ищет причины флакующих проверок и переводит сценарии с Cypress или Selenium. CX Codex +1 148установок playwright-testing alinaqi Скилл playwright-testing для E2E-тестов на Playwright: page objects, порядок локаторов и конфиг с прогоном в chromium, firefox, webkit и мобильных вьюпортах. CX Codex +1 3 400установок playwright gentleman-programming Скилл для написания E2E-тестов на Playwright с паттерном Page Objects. Помогает строить тесты через исследование реального UI с MCP-инструментами, затем кодировать селекторы и проверки на основе точных данных. CX Codex +1 194установок e2e-setup davila7 Команда e2e-setup разворачивает сквозное E2E-тестирование в проекте, подбирает фреймворк и настраивает запуск тестов в CI. CX Codex +1 477установок cypress-automation kindlmann Скилл cypress-automation для написания тестов на Cypress в TypeScript: E2E, компонентные тесты, cy.intercept, cy.session и запуск в CI. CX Codex +1 1 300установок playwright-e2e-builder davila7 Скилл playwright-e2e-builder планирует и собирает E2E-тесты на Playwright: сначала расспрашивает про сценарии и авторизацию, потом пишет код. CX Codex +1 271установок

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

Весь набор →
api-test-suite-generator Скилл api-test-suite-generator для Claude Code сканирует определения маршрутов и генерирует тесты API на Jest, Vitest или Supertest. Закрывает покрытие эндпоинтов, у которых тестов ещё нет. CX Codex +1 319установок prisma-migration-assistant Скилл prisma-migration-assistant помогает планировать и проводить миграции Prisma без потери данных. Подходит для разделения колонок, смены типов и безопасного наполнения таблиц. CX Codex +1 316установок vscode-workspace-setup Скилл vscode-workspace-setup для Claude Code создаёт в проекте папку .vscode с едиными настройками редактора, рекомендациями расширений, задачами сборки и отладкой. Унифицирует форматирование и линт в команде. CX Codex +1 313установок readme-generator Скилл readme-generator создаёт структурированный README.md с бейджами, шагами установки, таблицами API и правилами контрибьютинга. Пригодится при оформлении новых репозиториев. CX Codex +1 313установок page-layout-builder Скилл page-layout-builder для Claude Code собирает каркасы страниц dashboard, авторизации, настроек и CRUD. Создаёт маршруты, навигацию и заготовки состояния. CX Codex +1 312установок curl-command-generator Скилл curl-command-generator собирает готовые cURL-команды по определениям маршрутов в Express, Next.js или Fastify: с методами, заголовками, токеном и телом запроса. CX Codex +1 311установок data-integrity-auditor Скилл data-integrity-auditor для Claude Code ищет нарушения целостности данных и предлагает исправления. Запускается по запросам об orphaned records, связях между таблицами и качестве данных. CX Codex +1 306установок queue-job-processor Скилл queue-job-processor настраивает фоновые очереди задач на базе BullMQ и Redis, включая воркеры, повторные попытки и отслеживание прогресса. CX Codex +1 300установок

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

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