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

visual-testing-advanced — скилл для Claude Code

Скилл visual-testing-advanced настраивает продвинутое визуальное регрессионное тестирование интерфейса, сравнение скриншотов по пикселям и адаптивную проверку верстки.

MIT 163 установок ★ 533 обновлён 2026-10-25

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

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

Скилл координирует проверку интерфейсов через агентов qe-visual-tester, qe-test-executor и qe-quality-gate. Основной сценарий опирается на инструмент qe-browser и Vibium для сбора базовых эталонов и запуска диффов через node .claude/skills/qe-browser/scripts/visual-diff.js. Эталонные снимки сохраняются в папку .aqe/visual-baselines/. При несовпадении пикселей выше заданного порога скрипт возвращает ненулевой код выхода, поэтому с его помощью легко блокировать сборку в CI.

Второй путь предназначен для сценариев с Playwright и Percy. Он выручает, когда нужно скрыть динамические блоки вроде счетчиков или рекламы через маскирование, проверить верстку в Firefox и WebKit либо задействовать алгоритмы Percy для игнорирования незначительного сдвига шрифтов. Vibium на текущий момент работает только с Chrome, поэтому для кроссбраузерной проверки скилл переключается на Playwright.

Шаблон также описывает работу с брейкпоинтами для мобильных экранов, планшетов и десктопов. Вы можете сравнивать страницу целиком или изолировать конкретный блок через CSS-селектор.

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

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

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

  • Сделай baseline-скриншоты главной страницы для мобильного и десктопного экранов
  • Сравни текущую ветку с веткой main и найди визуальные регрессии на странице checkout
  • Настрой маскирование динамических блоков .timestamp и .user-count для тестов в Playwright

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

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill visual-testing-advanced -a claude-code

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

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

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

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

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

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

Выполните в терминале команду npx skills add proffesor-for-testing/agentic-qe --skill visual-testing-advanced -a claude-code.

Что делает этот скилл?

Он предоставляет инструкции и готовые скрипты для сверки скриншотов, обнаружения поломок верстки и организации проверок через Playwright или Vibium.

Когда вместо связки с Vibium нужен Playwright?

Playwright потребуется, если вам необходимы тесты в Firefox или WebKit, а также если вы используете Percy для исключения ложных срабатываний из-за сглаживания шрифтов.

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

SKILL.md · MIT
---
name: visual-testing-advanced
description: "Advanced visual regression testing with pixel-perfect comparison, AI-powered diff analysis, responsive design validation, and cross-browser visual consistency. Use when detecting UI regressions, validating designs, or ensuring visual consistency."
category: specialized-testing
priority: high
tokenEstimate: 900
agents: [qe-visual-tester, qe-test-executor, qe-quality-gate]
implementation_status: optimized
optimization_version: 1.0
last_optimized: 2025-12-02
dependencies: []
quick_reference_card: true
tags: [visual, regression, screenshot, pixel-diff, percy, playwright, responsive]
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/visual-testing-advanced.yaml
---

# Advanced Visual Testing

<default_to_action>
When detecting visual regressions or validating UI:
1. CAPTURE baseline screenshots (first run establishes baseline)
2. COMPARE new screenshots against baseline (pixel-by-pixel or AI)
3. MASK dynamic content (timestamps, ads, user counts)
4. TEST across devices (desktop, tablet, mobile viewports)
5. REVIEW and approve intentional changes, fail on regressions

**Quick Visual Testing Steps:**
- Set up baseline on main branch
- Compare feature branch against baseline
- Mask dynamic elements (timestamps, avatars)
- Use AI-powered comparison to reduce false positives
- Integrate in CI/CD to block visual regressions

**Critical Success Factors:**
- Functional tests don't catch visual bugs
- AI-powered tools reduce false positives
- Review diffs, don't just auto-approve
</default_to_action>

## Quick Reference Card

### When to Use
- UI component changes
- CSS/styling modifications
- Responsive design validation
- Cross-browser consistency checks

### Visual Bug Types
| Bug Type | Description |
|----------|-------------|
| Layout shift | Elements moved position |
| Color change | Unintended color modification |
| Font rendering | Typography issues |
| Alignment | Spacing/alignment problems |
| Missing images | Broken image paths |
| Overflow | Content clipping |

### Comparison Algorithms
| Algorithm | Best For |
|-----------|----------|
| **Pixel diff** | Exact match requirement |
| **Structural similarity** | Handle anti-aliasing |
| **AI semantic** | Ignore insignificant changes |

---

## PRIMARY PATH: qe-browser visual-diff

**Most visual regression work should go through the `qe-browser` fleet skill.** It wraps Vibium (WebDriver BiDi) and provides pixel-diff against stored baselines with threshold enforcement and diff-image output. See `.claude/skills/qe-browser/SKILL.md`.

```bash
# Navigate
vibium go https://example.com
vibium wait load

# First run — creates baseline in .aqe/visual-baselines/homepage.png
node .claude/skills/qe-browser/scripts/visual-diff.js --name homepage

# Subsequent runs — compare, non-zero exit on mismatch
node .claude/skills/qe-browser/scripts/visual-diff.js --name homepage --threshold 0.02

# Scope to a single region
node .claude/skills/qe-browser/scripts/visual-diff.js --name hero --selector "#hero"

# Responsive — run diff at each breakpoint
for viewport in "375 667" "768 1024" "1920 1080"; do
  read w h <<< "$viewport"
  vibium viewport $w $h
  node .claude/skills/qe-browser/scripts/visual-diff.js --name "homepage-${w}x${h}"
done

# Reset baseline after an intentional design change
node .claude/skills/qe-browser/scripts/visual-diff.js --name homepage --update-baseline
```

Baselines live in `.aqe/visual-baselines/`. The script uses `pixelmatch` when installed, with a hash-based exact-match fallback otherwise. Non-zero exit when similarity < `1 - threshold`, so CI gating is `$?`-based.

### When to keep Playwright visual regression

Use the Playwright recipe below only when you need:
- **AI semantic comparison** (Percy, Applitools) to ignore insignificant pixel drift
- **Cross-browser rendering checks** in Firefox/WebKit (Vibium is Chrome-only today)
- **Tight integration with an existing Playwright test suite**

---

## LEGACY: Visual Regression with Playwright (fallback)

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

test('homepage visual regression', async ({ page }) => {
  await page.goto('https://example.com');

  // Capture and compare screenshot
  await expect(page).toHaveScreenshot('homepage.png');
  // First run: saves baseline
  // Subsequent runs: compares to baseline
});

test('responsive design', async ({ page }) => {
  // Mobile viewport
  await page.setViewportSize({ width: 375, height: 667 });
  await page.goto('https://example.com');
  await expect(page).toHaveScreenshot('homepage-mobile.png');

  // Tablet viewport
  await page.setViewportSize({ width: 768, height: 1024 });
  await expect(page).toHaveScreenshot('homepage-tablet.png');
});
```

---

## Handling Dynamic Content

```javascript
test('mask dynamic elements', async ({ page }) => {
  await page.goto('https://example.com');

  await expect(page).toHaveScreenshot({
    mask: [
      page.locator('.timestamp'),     // Dynamic time
      page.locator('.user-count'),    // Live counter
      page.locator('.advertisement'), // Ads
      page.locator('.avatar')         // User avatars
    ]
  });
});
```

---

## AI-Powered Visual Testing (Percy)

```javascript
import percySnapshot from '@percy/playwright';

test('AI-powered visual test', async ({ page }) => {
  await page.goto('https://example.com');

  // Percy uses AI to ignore anti-aliasing, minor font differences
  await percySnapshot(page, 'Homepage');
});

test('component visual test', async ({ page }) => {
  await page.goto('https://example.com/components');

  // Snapshot specific component
  const button = page.locator('.primary-button');
  await percySnapshot(page, 'Primary Button', {
    scope: button
  });
});
```

---

## Playwright Configuration

```javascript
// playwright.config.js
export default {
  expect: {
    toHaveScreenshot: {
      maxDiffPixels: 100,      // Allow 100 pixel difference
      maxDiffPixelRatio: 0.01, // Or 1% of image
      threshold: 0.2,          // Color similarity threshold
      animations: 'disabled',  // Disable animations
      caret: 'hide'            // Hide cursor
    }
  }
};
```

---

## Agent-Driven Visual Testing

```typescript
// Comprehensive visual regression
await Task("Visual Regression Suite", {
  baseline: 'main-branch',
  current: 'feature-branch',
  pages: ['homepage', 'product', 'checkout'],
  devices: ['desktop', 'tablet', 'mobile'],
  browsers: ['chrome', 'firefox', 'safari'],
  threshold: 0.01
}, "qe-visual-tester");

// Returns:
// {
//   comparisons: 27,  // 3 pages × 3 devices × 3 browsers
//   differences: 2,
//   report: 'visual-regression-report.html'
// }
```

---

## Agent Coordination Hints

### Memory Namespace
```
aqe/visual-testing/
├── baselines/*          - Baseline screenshots
├── comparisons/*        - Diff results
├── components/*         - Component snapshots
└── reports/*            - Visual regression reports
```

### Fleet Coordination
```typescript
const visualFleet = await FleetManager.coordinate({
  strategy: 'visual-testing',
  agents: [
    'qe-visual-tester',   // Screenshot comparison
    'qe-test-executor',   // Cross-browser execution
    'qe-quality-gate'     // Block on visual regressions
  ],
  topology: 'parallel'
});
```

---

## Related Skills
- [accessibility-testing](../accessibility-testing/) - Visual a11y checks
- [compatibility-testing](../compatibility-testing/) - Cross-browser visuals
- [regression-testing](../regression-testing/) - Regression suite

---

## Remember

**Functional tests don't catch visual bugs.** Layout shifts, color changes, font rendering, alignment issues - all invisible to functional tests but visible to users.

**AI-powered tools reduce false positives.** Percy, Applitools use AI to ignore insignificant differences (anti-aliasing, minor font rendering).

**With Agents:** `qe-visual-tester` automates visual regression across browsers and devices, uses AI to filter noise, and generates visual diff reports. Catches UI regressions before users see them.

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

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

Все скиллы по теме «Тесты и QA» →
visual-regression-testing aj-geddes Скилл visual-regression-testing ловит случайные визуальные изменения интерфейса: снимает скриншоты компонентов и страниц и сравнивает их между версиями. CX Codex +1 741установок visual-review ethanplusai Скилл visual-review для Claude Code доказывает, что пересборка на Astro совпадает с живым сайтом: снимает полноэкранные скриншоты обеих сторон и считает пиксельный диф. CX Codex +1 ★ 137звёзд репо playwright-visual-testing manutej Скилл playwright-visual-testing помогает проверять веб-интерфейсы через Playwright MCP: делать снимки страниц, проходить пользовательские сценарии и искать визуальные изменения. CX Codex +1 1 400установок visual-qa-testing spencerpauly Скилл visual-qa-testing для Claude Code открывает встроенный браузер, делает скриншот страницы и проверяет консоль на ошибки после изменений интерфейса. CX Codex +1 714установок visual-verdict Yeachan-Heo Скилл visual-verdict сравнивает полученный скриншот интерфейса с референсными изображениями и возвращает JSON-вердикт для следующей итерации правок. CX Codex +1 978установок visual-explainer vercel-labs Скилл visual-explainer превращает баги, PR и фичи в пошаговые инфографики с диаграммами, подсвеченным кодом и чётким разделением на «было» и «стало». CX Codex +1 235установок

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

Весь набор →
brutal-honesty-review Скилл brutal-honesty-review разбирает код, тесты и технические решения без смягчения критики. Агент указывает, что сломано, почему это проблема и как исправить. CX Codex +1 186установок mobile-testing Скилл mobile-testing для тестирования iOS и Android приложений: жесты, сенсоры, разрешения, фрагментация устройств и производительность. CX Codex +1 177установок n8n-workflow-testing-fundamentals Скилл n8n-workflow-testing-fundamentals для тестирования n8n-воркфлоу: проверяет структуру, узлы, потоки данных, обработку ошибок и производительность автоматизаций. CX Codex +1 176установок n8n-security-testing Скилл n8n-security-testing проверяет сценарии n8n на утечки секретов, тестирует шифрование данных и валидирует авторизацию вебхуков. CX Codex +1 176установок pr-review Скилл pr-review проверяет GitHub PR по объёму изменений, trust tier, качеству кода и безопасности. Он помогает подготовить понятный автору отзыв с конкретными действиями. CX Codex +1 155установок agentic-quality-engineering Скилл agentic-quality-engineering помогает координировать ИИ-агентов для тестирования, анализа рисков и контроля качества. Он задаёт принципы PACTS и подсказывает, каких субагентов подключить к задаче. CX Codex +1 153установок security-testing Скилл security-testing для Claude Code проверяет проект на уязвимости по методике OWASP Top 10. Подключается для аудита авторизации, поиска инъекций и настройки автоматических проверок. CX Codex +1 152установок pentest-validation Скилл pentest-validation проверяет отчёты SAST и DAST на реальную эксплуатируемость, отсеивает ложные срабатывания и строит PoC без тестов на проде. CX Codex +1 147установок

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

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