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

playwright-visual-testing · bradtaylorsf — скилл для Claude Code: установка

Скилл playwright-visual-testing с готовыми шаблонами визуального регрессионного тестирования на Playwright. Помогает настроить скриншотные тесты компонентов, маски динамических данных и снимки в CI.

MIT 1 установок ★ 8 обновлён 2026-02-05

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

Что делает playwright-visual-testing

Скилл передаёт агенту набор шаблонов для скриншотного тестирования через @playwright/test. Внутри собраны примеры проверок expect(page).toHaveScreenshot() с параметрами maxDiffPixels, threshold и цветовыми масками. Есть готовые решения для изоляции нестабильных данных: скрытие блоков через mask, подмена дат через page.evaluate и выключение CSS-анимаций через инъекцию стилей в addStyleTag.

Для адаптивной вёрстки описаны перебор экранов в цикле и конфигурация проектов в playwright.config.ts. Скилл включает проверку тёмной и светлой темы через page.emulateMedia, тестирование состояний кнопок (hover, focus, disabled) и шаблон пайплайна GitHub Actions с выгрузкой артефактов при падении.

В манифесте скилла задан параметр user-invocable: false, поэтому агент обращается к правилам сам при генерации кода. Без установленного пакета @playwright/test и браузерных бинарников эти сценарии в проекте не запустятся.

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

  • настроить проверку скриншотов страниц и отдельных компонентов
  • замаскировать динамические блоки и счётчики перед созданием снимка
  • отключить CSS-анимации интерфейса для устранения ложных расхождений
  • организовать тестирование светлой и тёмной темы в одном наборе тестов
  • сконфигурировать шаблон путей snapshotPathTemplate под разные платформы

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

  • Напиши визуальный тест для страницы /dashboard на Playwright, замаскируй динамические даты и аватары
  • Добавь в playwright.config.ts отключение анимаций и настройку путей к скриншотам для разных платформ
  • Создай тест состояний кнопки (обычное, hover, disabled) с сохранением снимков каждого вида

Как установить playwright-visual-testing

1Через Skills CLI (Vercel)

npx skills add bradtaylorsf/alphaagent-team --skill playwright-visual-testing -a claude-code

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

~/.claude/skills/playwright-visual-testing/SKILL.md

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

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

Вопросы о playwright-visual-testing

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

Выполните в терминале команду npx skills add bradtaylorsf/alphaagent-team --skill playwright-visual-testing -a claude-code.

Что делает playwright-visual-testing?

Скилл снабжает агента инструкциями по написанию скриншотных тестов на Playwright: сравнение страниц и компонентов, маскирование динамических данных, отключение анимаций и запуск в CI.

Можно ли вызвать скилл вручную через слэш-команду?

Нет, в метаданных скилла стоит user-invocable: false. Агент активирует эти шаблоны автоматически, когда получает задачу на визуальное тестирование или настройку снепшотов.

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

SKILL.md · MIT
---
name: playwright-visual-testing
description: Playwright visual comparison and screenshot testing
user-invocable: false
---

# Playwright Visual Testing Skill

Patterns for visual regression testing with Playwright.

## Screenshot Assertions

### Basic Screenshot Comparison

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

test('visual comparison', async ({ page }) => {
  await page.goto('/')

  // Compare full page
  await expect(page).toHaveScreenshot()

  // With custom name
  await expect(page).toHaveScreenshot('homepage.png')
})

// Element screenshot
test('component visual test', async ({ page }) => {
  await page.goto('/components')

  const card = page.locator('.card').first()
  await expect(card).toHaveScreenshot('card-component.png')
})
```

### Screenshot Options

```typescript
await expect(page).toHaveScreenshot('name.png', {
  // Comparison options
  maxDiffPixels: 100,           // Allow N different pixels
  maxDiffPixelRatio: 0.05,      // Allow 5% difference
  threshold: 0.2,                // Color difference threshold (0-1)

  // Capture options
  fullPage: true,                // Capture entire scrollable page
  clip: { x: 0, y: 0, width: 800, height: 600 },
  scale: 'css',                  // 'css' or 'device'
  animations: 'disabled',        // Disable animations
  mask: [page.locator('.dynamic')],  // Mask dynamic content
  maskColor: '#FF00FF',          // Mask overlay color
})
```

### Updating Snapshots

```bash
# Update all snapshots
npx playwright test --update-snapshots

# Update specific test
npx playwright test visual.spec.ts --update-snapshots
```

## Handling Dynamic Content

### Masking Elements

```typescript
test('mask dynamic content', async ({ page }) => {
  await page.goto('/dashboard')

  await expect(page).toHaveScreenshot('dashboard.png', {
    mask: [
      page.locator('.timestamp'),
      page.locator('.user-avatar'),
      page.locator('.random-ad'),
    ],
  })
})
```

### Waiting for Stability

```typescript
test('wait for animations', async ({ page }) => {
  await page.goto('/animated-page')

  // Wait for animations to complete
  await page.waitForTimeout(500)

  // Or wait for specific state
  await page.locator('.loading').waitFor({ state: 'hidden' })

  await expect(page).toHaveScreenshot()
})
```

### Disabling Animations

```typescript
// playwright.config.ts
export default defineConfig({
  use: {
    // Disable CSS animations and transitions
    // JS animations need manual handling
  },
})

// In test
test('no animations', async ({ page }) => {
  await page.goto('/')

  // Add CSS to disable animations
  await page.addStyleTag({
    content: `
      *, *::before, *::after {
        animation-duration: 0s !important;
        animation-delay: 0s !important;
        transition-duration: 0s !important;
        transition-delay: 0s !important;
      }
    `,
  })

  await expect(page).toHaveScreenshot()
})
```

### Replacing Dynamic Content

```typescript
test('replace dynamic dates', async ({ page }) => {
  await page.goto('/orders')

  // Replace dynamic dates with static text
  await page.evaluate(() => {
    document.querySelectorAll('.date').forEach(el => {
      el.textContent = 'FIXED_DATE'
    })
  })

  await expect(page).toHaveScreenshot()
})
```

## Responsive Testing

### Multiple Viewports

```typescript
const viewports = [
  { name: 'mobile', width: 375, height: 667 },
  { name: 'tablet', width: 768, height: 1024 },
  { name: 'desktop', width: 1280, height: 720 },
]

for (const viewport of viewports) {
  test(`homepage - ${viewport.name}`, async ({ page }) => {
    await page.setViewportSize(viewport)
    await page.goto('/')

    await expect(page).toHaveScreenshot(`homepage-${viewport.name}.png`)
  })
}
```

### Using Projects

```typescript
// playwright.config.ts
export default defineConfig({
  projects: [
    {
      name: 'desktop-chrome',
      use: {
        ...devices['Desktop Chrome'],
        viewport: { width: 1280, height: 720 },
      },
    },
    {
      name: 'mobile-safari',
      use: {
        ...devices['iPhone 13'],
      },
    },
    {
      name: 'tablet-portrait',
      use: {
        ...devices['iPad Pro 11'],
      },
    },
  ],
})
```

## Theming and States

### Dark Mode

```typescript
test('dark mode', async ({ page }) => {
  await page.emulateMedia({ colorScheme: 'dark' })
  await page.goto('/')

  await expect(page).toHaveScreenshot('homepage-dark.png')
})

test('light mode', async ({ page }) => {
  await page.emulateMedia({ colorScheme: 'light' })
  await page.goto('/')

  await expect(page).toHaveScreenshot('homepage-light.png')
})
```

### Component States

```typescript
test('button states', async ({ page }) => {
  await page.goto('/components/button')

  const button = page.getByRole('button', { name: 'Submit' })

  // Default state
  await expect(button).toHaveScreenshot('button-default.png')

  // Hover state
  await button.hover()
  await expect(button).toHaveScreenshot('button-hover.png')

  // Focus state
  await button.focus()
  await expect(button).toHaveScreenshot('button-focus.png')

  // Disabled state
  await page.evaluate(() => {
    (document.querySelector('button') as HTMLButtonElement).disabled = true
  })
  await expect(button).toHaveScreenshot('button-disabled.png')
})
```

## Configuration

### Global Config

```typescript
// playwright.config.ts
export default defineConfig({
  expect: {
    toHaveScreenshot: {
      // Default comparison options
      maxDiffPixels: 50,
      threshold: 0.3,
      animations: 'disabled',
    },
    toMatchSnapshot: {
      maxDiffPixelRatio: 0.05,
    },
  },

  // Snapshot directory
  snapshotDir: './screenshots',

  // Platform-specific snapshots
  snapshotPathTemplate: '{testDir}/{testFileDir}/{testFileName}-snapshots/{arg}{-projectName}{ext}',
})
```

### Platform Handling

```typescript
// Separate snapshots per platform
// playwright.config.ts
export default defineConfig({
  snapshotPathTemplate: '{testDir}/__snapshots__/{testFileName}/{arg}-{projectName}-{platform}{ext}',
})

// Or ignore platform differences
test('cross-platform visual', async ({ page }) => {
  await page.goto('/')

  await expect(page).toHaveScreenshot('homepage.png', {
    maxDiffPixelRatio: 0.1,  // Allow platform font differences
  })
})
```

## CI Integration

### GitHub Actions

```yaml
# .github/workflows/visual.yml
name: Visual Tests

on: [push, pull_request]

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

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

      - run: npm ci
      - run: npx playwright install --with-deps

      - run: npx playwright test

      - uses: actions/upload-artifact@v4
        if: failure()
        with:
          name: visual-test-results
          path: test-results/
          retention-days: 7
```

### Updating in CI

```bash
# Update snapshots in CI (usually PR)
npx playwright test --update-snapshots

# Commit updated snapshots
git add **/*.png
git commit -m "Update visual snapshots"
```

## Best Practices

### Stable Screenshots

```typescript
test('stable visual test', async ({ page }) => {
  // 1. Use consistent viewport
  await page.setViewportSize({ width: 1280, height: 720 })

  // 2. Load page and wait
  await page.goto('/', { waitUntil: 'networkidle' })

  // 3. Wait for fonts to load
  await page.waitForFunction(() => document.fonts.ready)

  // 4. Disable animations
  await page.addStyleTag({
    content: '* { animation: none !important; transition: none !important; }'
  })

  // 5. Mask dynamic content
  await expect(page).toHaveScreenshot('page.png', {
    mask: [page.locator('.timestamp'), page.locator('.ad')],
  })
})
```

### Organizing Snapshots

```
tests/
├── visual/
│   ├── homepage.spec.ts
│   ├── dashboard.spec.ts
│   └── components.spec.ts
├── __snapshots__/
│   ├── homepage.spec.ts-snapshots/
│   │   ├── homepage-desktop-chromium.png
│   │   └── homepage-mobile-webkit.png
│   └── components.spec.ts-snapshots/
│       ├── button-default.png
│       └── button-hover.png
```

## Integration

Used by:
- `frontend-developer` agent
- `fullstack-developer` agent

© bradtaylorsf · MIT · bradtaylorsf/alphaagent-team

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

Все скиллы по теме «Тесты и QA» →

Сначала — playwright-visual-testing от других авторов.

playwright-visual-testing manutej Скилл playwright-visual-testing помогает проверять веб-интерфейсы через Playwright MCP: делать снимки страниц, проходить пользовательские сценарии и искать визуальные изменения. CX Codex +1 1 400установок playwright secondsky Скилл для браузерной автоматизации и E2E-тестов на Playwright. Сам находит запущенный dev-сервер и пишет скрипты под вашу задачу. CX Codex +1 1 100установок playwright-screenshot-inspector curiositech Скилл playwright-screenshot-inspector для визуального тестирования веб-интерфейсов: запускает Playwright в headless-режиме, делает скриншоты и анализирует их через мультимодальную модель. CX Codex +1 262установок playwright-e2e-testing-cursorrules-prompt-file PatrickJS Правило playwright-e2e-testing-cursorrules-prompt-file для Cursor, которое генерирует файлы тестов Playwright по описанию фичи: 3–5 сценариев для проверки ключевых пользовательских путей — входа, регистрации, оформления заказа. CX Codex +1 ★ 41 178звёзд репо setup-visual-testing davila7 Слэш-команда setup-visual-testing разворачивает визуальное регрессионное тестирование: снимки компонентов и страниц, адаптивные брейкпоинты, проверка доступности. CX Codex +1 300установок visual-testing kindlmann Скилл visual-testing для визуального регрессионного тестирования: сравнивает скриншоты с эталонами и ловит различия на уровне пикселей, которые пропускают функциональные тесты. CX Codex +1 1 500установок visual-regression-testing aj-geddes Скилл visual-regression-testing ловит случайные визуальные изменения интерфейса: снимает скриншоты компонентов и страниц и сравнивает их между версиями. CX Codex +1 741установок

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

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

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