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

test-automation-expert — скилл для Claude Code: тесты от unit до E2E

Скилл test-automation-expert для Claude Code помогает выстроить стратегию тестирования, определить покрытие, выбрать фреймворк и отладить флаки-тесты.

MIT 212 установок ★ 274 обновлён 2026-10-30

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

Что делает test-automation-expert

Скилл ведёт по всей пирамиде тестирования: unit-тесты, интеграционные проверки и E2E-сценарии. Помогает выбрать фреймворк под проект — Vitest для Vite, Jest для устоявшихся React-проектов, Playwright или Cypress для браузерных проверок, pytest для Python. Заодно подсказывает распределение: 70% unit, 20% интеграционных, 10% E2E, с ориентирами по времени выполнения.

Внутри — паттерны Arrange-Act-Assert, стратегии мокинга на границах модулей, чеклист изоляции тестов: независимый запуск, сброс состояния базы, безопасность параллельного выполнения. Для интеграционных тестов есть примеры с тестовой базой и проверкой побочных эффектов.

Скилл не про ручное QA, нагрузочное тестирование и безопасность. Для производительности автор отсылает к performance-engineer, для security — к security-auditor. Активируется по фразам вроде «test strategy», «flaky tests», «mocking», «TDD», «BDD». Из инструментов доступны чтение, запись, правка и Bash-команды: npm test:*, npx jest:*, npx vitest:*, npx playwright:*, pytest:*.

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

  • выбрать тестовый фреймворк под стек проекта
  • настроить Jest, Vitest, Playwright, Cypress или pytest с нуля
  • найти и починить флаки-тесты
  • выстроить пирамиду тестов с адекватным покрытием
  • подготовить моки и фикстуры без привязки к деталям реализации

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

  • Спроектируй тестовую стратегию для нового React-проекта на Vite
  • Напиши unit-тесты для validateEmail по паттерну Arrange-Act-Assert
  • Разбери, почему этот Playwright-тест падает через раз, и предложи фикс

Как установить test-automation-expert

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill test-automation-expert -a claude-code

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

~/.claude/skills/test-automation-expert/SKILL.md

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

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

Вопросы о test-automation-expert

Как установить test-automation-expert в Claude Code?

Выполни npx skills add curiositech/some_claude_skills --skill test-automation-expert -a claude-code. После установки скилл будет лежать в ~/.claude/skills/test-automation-expert/SKILL.md.

Что делает test-automation-expert?

Помогает проектировать стратегию тестирования, настраивать фреймворки (Jest, Vitest, Playwright, Cypress, pytest), писать unit-, интеграционные и E2E-тесты, отлаживать флаки и встраивать тесты в CI/CD.

Для чего этот скилл не подходит?

Не для ручного написания QA-кейсов, нагрузочного тестирования и проверки безопасности. Для этих задач автор предлагает отдельные скиллы: performance-engineer и security-auditor.

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

SKILL.md · MIT
---
name: test-automation-expert
description: Comprehensive test automation specialist covering unit, integration, and E2E testing strategies. Expert in Jest, Vitest, Playwright, Cypress, pytest, and modern testing frameworks. Guides test
  pyramid design, coverage optimization, flaky test detection, and CI/CD integration. Activate on 'test strategy', 'unit tests', 'integration tests', 'E2E testing', 'test coverage', 'flaky tests', 'mocking',
  'test fixtures', 'TDD', 'BDD', 'test automation'. NOT for manual QA processes, load/performance testing (use performance-engineer), or security testing (use security-auditor).
allowed-tools: Read,Write,Edit,Bash(npm test:*,npx jest:*,npx vitest:*,npx playwright:*,pytest:*),Grep,Glob
metadata:
  category: Code Quality & Testing
  pairs-with:
  - skill: refactoring-surgeon
    reason: Tests before refactoring
  - skill: devops-automator
    reason: CI/CD test integration
  tags:
  - testing
  - jest
  - playwright
  - tdd
  - coverage
---

# Test Automation Expert

Comprehensive testing guidance from unit to E2E. Designs test strategies, implements automation, and optimizes coverage for sustainable quality.

## When to Use

**Use for:**
- Designing test strategy for new projects
- Setting up testing frameworks (Jest, Vitest, Playwright, Cypress, pytest)
- Writing effective unit, integration, and E2E tests
- Optimizing test coverage and eliminating gaps
- Debugging flaky tests
- CI/CD test pipeline configuration
- Test-Driven Development (TDD) guidance
- Mocking strategies and test fixtures

**Do NOT use for:**
- Manual QA test case writing - this is automation-focused
- Load/performance testing - use performance-engineer skill
- Security testing - use security-auditor skill
- API contract testing only - use backend-architect for API design

## Test Pyramid Philosophy

```
         /\
        /  \      E2E Tests (10%)
       /----\     - Critical user journeys
      /      \    - Cross-browser validation
     /--------\
    /          \  Integration Tests (20%)
   /            \ - API contracts
  /--------------\- Component interactions
 /                \
/------------------\ Unit Tests (70%)
                    - Fast, isolated, deterministic
                    - Business logic validation
```

### Distribution Guidelines

| Test Type | Percentage | Execution Time | Purpose |
|-----------|------------|----------------|---------|
| Unit | 70% | < 100ms each | Logic validation |
| Integration | 20% | < 1s each | Component contracts |
| E2E | 10% | < 30s each | Critical paths |

## Framework Selection

### JavaScript/TypeScript

| Framework | Best For | Speed | Config Complexity |
|-----------|----------|-------|-------------------|
| **Vitest** | Vite projects, modern ESM | Fastest | Low |
| **Jest** | React, established projects | Fast | Medium |
| **Playwright** | E2E, cross-browser | N/A | Low |
| **Cypress** | E2E, component testing | N/A | Medium |

### Python

| Framework | Best For | Speed | Features |
|-----------|----------|-------|----------|
| **pytest** | Everything | Fast | Fixtures, plugins |
| **unittest** | Standard library | Medium | Built-in |
| **hypothesis** | Property-based | Varies | Generative |

### Decision Tree: Framework Selection

```
New project?
├── Yes → Using Vite?
│   ├── Yes → Vitest
│   └── No → Jest or Vitest (both work)
└── No → What exists?
    ├── Jest → Keep Jest (migration cost rarely worth it)
    ├── Mocha → Consider migration to Vitest
    └── Nothing → Vitest (modern default)

Need E2E?
├── Cross-browser critical → Playwright
├── Developer experience priority → Cypress
└── Both → Playwright (more flexible)
```

## Unit Testing Patterns

### Good Unit Test Anatomy

```javascript
describe('UserService', () => {
  describe('validateEmail', () => {
    // Arrange-Act-Assert pattern
    it('should accept valid email formats', () => {
      // Arrange
      const validEmails = ['[email protected]', '[email protected]'];

      // Act & Assert
      validEmails.forEach(email => {
        expect(validateEmail(email)).toBe(true);
      });
    });

    it('should reject invalid email formats', () => {
      // Arrange
      const invalidEmails = ['invalid', '@missing.com', 'no@tld'];

      // Act & Assert
      invalidEmails.forEach(email => {
        expect(validateEmail(email)).toBe(false);
      });
    });

    // Edge cases explicitly tested
    it('should handle empty string', () => {
      expect(validateEmail('')).toBe(false);
    });

    it('should handle null/undefined', () => {
      expect(validateEmail(null)).toBe(false);
      expect(validateEmail(undefined)).toBe(false);
    });
  });
});
```

### Mocking Strategies

```javascript
// ✅ Good: Mock at boundaries
jest.mock('../services/api', () => ({
  fetchUser: jest.fn()
}));

// ✅ Good: Explicit mock setup per test
beforeEach(() => {
  fetchUser.mockReset();
});

it('handles user not found', async () => {
  fetchUser.mockRejectedValue(new NotFoundError());
  await expect(getUser(123)).rejects.toThrow('User not found');
});

// ❌ Bad: Mocking implementation details
jest.mock('../utils/internal-helper'); // Don't mock internals
```

### Test Isolation Checklist

- [ ] Each test can run independently
- [ ] No shared mutable state between tests
- [ ] Database/API state reset between tests
- [ ] No test order dependencies
- [ ] Parallel execution safe

## Integration Testing Patterns

### API Integration Test

```javascript
describe('POST /api/users', () => {
  let app;
  let db;

  beforeAll(async () => {
    db = await createTestDatabase();
    app = createApp({ db });
  });

  afterAll(async () => {
    await db.close();
  });

  beforeEach(async () => {
    await db.clear();
  });

  it('creates user with valid data', async () => {
    const response = await request(app)
      .post('/api/users')
      .send({ name: 'Test', email: '[email protected]' })
      .expect(201);

    expect(response.body).toMatchObject({
      id: expect.any(String),
      name: 'Test',
      email: '[email protected]'
    });

    // Verify side effects
    const dbUser = await db.users.findById(response.body.id);
    expect(dbUser).toBeDefined();
  });

  it('rejects duplicate email', async () => {
    await db.users.create({ name: 'Existing', email: '[email protected]' });

    await request(app)
      .post('/api/users')
      .send({ name: 'New', email: '[email protected]' })
      .expect(409);
  });
});
```

### Component Integration (React)

```javascript
import { render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { UserProfile } from './UserProfile';
import { UserProvider } from '../context/UserContext';

describe('UserProfile integration', () => {
  it('loads and displays user data', async () => {
    render(
      <UserProvider>
        <UserProfile userId="123" />
      </UserProvider>
    );

    // Verify loading state
    expect(screen.getByRole('progressbar')).toBeInTheDocument();

    // Wait for data
    await waitFor(() => {
      expect(screen.getByText('John Doe')).toBeInTheDocument();
    });

    // Verify loaded state
    expect(screen.queryByRole('progressbar')).not.toBeInTheDocument();
  });
});
```

## E2E Testing Patterns

### Playwright Best Practices

```javascript
import { test, expect } from '@playwright/test';

test.describe('Checkout Flow', () => {
  test.beforeEach(async ({ page }) => {
    // Seed test data via API
    await page.request.post('/api/test/seed', {
      data: { scenario: 'checkout-ready' }
    });
  });

  test('complete purchase with credit card', async ({ page }) => {
    await page.goto('/cart');

    // Use accessible selectors
    await page.getByRole('button', { name: 'Proceed to checkout' }).click();

    // Fill payment form
    await page.getByLabel('Card number').fill('4242424242424242');
    await page.getByLabel('Expiry').fill('12/25');
    await page.getByLabel('CVC').fill('123');

    // Complete purchase
    await page.getByRole('button', { name: 'Pay now' }).click();

    // Verify success
    await expect(page.getByRole('heading', { name: 'Order confirmed' })).toBeVisible();
    await expect(page.getByText(/Order #\d+/)).toBeVisible();
  });

  test('shows error for declined card', async ({ page }) => {
    await page.goto('/checkout');

    // Use test card that triggers decline
    await page.getByLabel('Card number').fill('4000000000000002');
    await page.getByLabel('Expiry').fill('12/25');
    await page.getByLabel('CVC').fill('123');

    await page.getByRole('button', { name: 'Pay now' }).click();

    await expect(page.getByRole('alert')).toContainText('Card declined');
  });
});
```

### Flaky Test Detection & Prevention

**Common Causes:**
1. Race conditions in async operations
2. Time-dependent tests
3. Shared state between tests
4. Network variability
5. Animation/transition timing

**Fixes:**

```javascript
// ❌ Bad: Fixed timeout
await page.waitForTimeout(2000);

// ✅ Good: Wait for specific condition
await expect(page.getByText('Loaded')).toBeVisible();

// ❌ Bad: Checking exact time
expect(new Date()).toEqual(specificDate);

// ✅ Good: Mock time
jest.useFakeTimers();
jest.setSystemTime(new Date('2024-01-15'));

// ❌ Bad: Depending on animation completion
await page.click('.button');
expect(await page.isVisible('.modal')).toBe(true);

// ✅ Good: Wait for animation
await page.click('.button');
await expect(page.locator('.modal')).toBeVisible();
```

## Coverage Optimization

### What to Measure

| Metric | Target | Priority |
|--------|--------|----------|
| Line coverage | 80%+ | Medium |
| Branch coverage | 75%+ | High |
| Function coverage | 90%+ | Medium |
| Critical path coverage | 100% | Critical |

### Coverage Configuration

```javascript
// vitest.config.js
export default defineConfig({
  test: {
    coverage: {
      provider: 'v8',
      reporter: ['text', 'json', 'html'],
      exclude: [
        'node_modules/',
        'test/',
        '**/*.d.ts',
        '**/*.config.*',
        '**/index.ts', // barrel files
      ],
      thresholds: {
        branches: 75,
        functions: 80,
        lines: 80,
        statements: 80
      }
    }
  }
});
```

### Finding Coverage Gaps

```bash
# Generate detailed coverage report
npx vitest run --coverage

# Find untested files
npx vitest run --coverage --reporter=json | jq '.coverageMap | to_entries | map(select(.value.s | values | any(. == 0))) | .[].key'
```

## CI/CD Integration

### GitHub Actions

```yaml
name: Tests
on: [push, pull_request]

jobs:
  unit-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm test -- --coverage
      - uses: codecov/codecov-action@v4

  e2e-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npm run test:e2e
      - uses: actions/upload-artifact@v4
        if: failure()
        with:
          name: playwright-report
          path: playwright-report/
```

### Test Parallelization

```javascript
// vitest.config.js - parallel by default
export default defineConfig({
  test: {
    pool: 'threads',
    poolOptions: {
      threads: {
        singleThread: false
      }
    }
  }
});

// playwright.config.js
export default defineConfig({
  workers: process.env.CI ? 2 : undefined,
  fullyParallel: true
});
```

## Anti-Patterns

### Anti-Pattern: Testing Implementation Details

**What it looks like:**
```javascript
// ❌ Testing internal state
expect(component.state.isLoading).toBe(true);

// ❌ Testing private methods
expect(service._calculateHash()).toBe('abc123');
```

**Why wrong:** Couples tests to implementation, breaks on refactors

**Instead:**
```javascript
// ✅ Test observable behavior
expect(screen.getByRole('progressbar')).toBeInTheDocument();

// ✅ Test public interface
expect(service.getHash()).toBe('abc123');
```

### Anti-Pattern: Over-Mocking

**What it looks like:**
```javascript
// ❌ Mocking everything
jest.mock('../utils/format');
jest.mock('../utils/validate');
jest.mock('../utils/transform');
```

**Why wrong:** Tests pass even when real code is broken

**Instead:** Mock only at system boundaries (APIs, databases, external services)

### Anti-Pattern: Flaky Acceptance

**What it looks like:** "That test is just flaky, skip it"

**Why wrong:** Flaky tests indicate real problems (race conditions, timing issues)

**Instead:** Fix the flakiness or quarantine while fixing

### Anti-Pattern: Coverage Theater

**What it looks like:**
```javascript
// ❌ Testing for coverage, not behavior
it('covers the function', () => {
  myFunction();
  // No assertions!
});
```

**Why wrong:** 100% coverage with 0% confidence

**Instead:** Every test should assert meaningful behavior

## Quick Commands

```bash
# Run all tests
npm test

# Run with coverage
npm test -- --coverage

# Run specific file
npm test -- src/utils/format.test.ts

# Run in watch mode
npm test -- --watch

# Run E2E tests
npx playwright test

# Run E2E with UI
npx playwright test --ui

# Debug E2E test
npx playwright test --debug

# Update snapshots
npm test -- -u
```

## Reference Files

- `references/test-strategy.md` - Comprehensive test strategy framework
- `references/framework-comparison.md` - Detailed framework comparison
- `references/coverage-patterns.md` - Coverage optimization techniques
- `references/ci-integration.md` - CI/CD pipeline configurations

---

**Covers**: Test strategy | Unit testing | Integration testing | E2E testing | Coverage | CI/CD | Flaky test debugging

**Use with**: security-auditor (security tests) | performance-engineer (load tests) | code-reviewer (test quality)

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Тесты и QA» →
test-automation-orchestrator davila7 Команда test-automation-orchestrator анализирует тестовые файлы и настройки проекта, затем помогает спроектировать запуск тестов: параллельный, последовательный, условный или как часть CI/CD. CX Codex +1 350установок qe-test-generation proffesor-for-testing Скилл qe-test-generation для Claude Code создаёт тесты для нового и изменённого кода, включая проверки инвариантов и контрактов. Помогает находить пробелы в покрытии и переносить тесты между фреймворками. CX Codex +1 142установок test-detect davila7 Скилл test-detect определяет тестовый фреймворк в проекте и запускает подходящую проверку. Он также находит тесты для файла и создаёт базовые тесты. CX Codex +1 56установок test-migration kindlmann Скилл test-migration помогает перевести тесты с Selenium, Cypress, Jest, Mocha или Protractor на Playwright и Vitest так, чтобы покрытие не просело. CX Codex +1 1 300установок ai-test-generation kindlmann Скилл ai-test-generation для Claude Code строит пошаговый конвейер генерации новых автотестов из спецификаций, диффов кода, баг-репортов и схем OpenAPI. Защищает от выдуманных ручек API и пустых ассертов. CX Codex +1 1 600установок qe-test-execution proffesor-for-testing Скилл qe-test-execution для запуска тестов в Jest, Vitest и Playwright с параллелизацией через aqe, умным отбором по diff и автоповтором упавших проверок. CX Codex +1 122установок

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

Весь набор →
digital-estate-planner Скилл digital-estate-planner для Claude Code планирует цифровое наследство: учитывает аккаунты, пароли и криптоактивы, готовит инструкции доверенным лицам. Помогает подготовить доступ к данным на случай смерти или недееспособности. CX Codex +1 215установок data-pipeline-engineer Скилл data-pipeline-engineer проектирует пайплайны данных, слои Medallion, DAG для Airflow и модели dbt. Пригодится при настройке пакетной или потоковой обработки данных. CX Codex +1 215установок hipaa-compliance Скилл hipaa-compliance помогает проверять работу с PHI: аудит доступа, санитаризацию логов и требования к сессиям. Нужен при разработке функций с медицинскими данными. CX Codex +1 215установок web-wave-designer Скилл web-wave-designer для Claude Code генерирует водные эффекты для веба: океанские волны, рябь и подводное искажение. Создаёт живые фоны и интерфейсы с эффектом жидкости. CX Codex +1 214установок very-long-text-summarization Скилл very-long-text-summarization для обработки книг, справочников и больших кодбаз через многоуровневое извлечение знаний. Выдаёт карту знаний, а не просто сжатый пересказ. CX Codex +1 210установок rest-api-design Скилл rest-api-design помогает проектировать REST-маршруты с проверкой данных через Zod и документацией OpenAPI. Пригодится при создании API для Next.js App Router. CX Codex +1 209установок modern-auth-2026 Скилл modern-auth-2026 добавляет в агент сценарии беспарольного входа: passkeys через WebAuthn, OAuth от Apple и Google, а также magic links и синхронизацию учётных записей. CX Codex +1 208установок automatic-stateful-prompt-improver Скилл automatic-stateful-prompt-improver перехватывает сложные запросы и улучшает их с помощью алгоритмов DSPy, APE и OPRO. Сохраняет историю удачных формулировок через MCP-сервер. CX Codex +1 207установок

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

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