qe-visual-accessibility — скилл для Claude Code: суть и запуск
Скилл qe-visual-accessibility автоматизирует проверку доступности по стандарту WCAG 2.2 и находит сдвиги интерфейса по скриншотам. Помогает контролировать регрессии после правок стилей и компонентов.
MIT 1 установок ★ 533 обновлён 2026-10-25
npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a claude-codeЧто делает qe-visual-accessibility
Инструмент настраивает агентов на скриншотное тестирование и поиск визуальных регрессий между продакшеном и стейджингом. Для анализа доступности запускается движок axe-core, который проверяет контрастность текста, клавиатурную навигацию и атрибуты ARIA.
Вся браузерная автоматизация опирается на движок Vibium и связанный скилл qe-browser. Без предварительной установки бинарника vibium через команду aqe init прогон тестов завершится ошибкой. В сравнении пикселей можно задавать порог различий через флаг --threshold и исключать динамические блоки страницы вроде таймштампов селектором.
Какие задачи решает
- Найти визуальные регрессии интерфейса после обновления CSS
- Провести аудит доступности страниц по стандарту WCAG 2.2 AA
- Проверить вёрстку на экранах мобильных устройств, планшетов и десктопов
- Исключить динамические блоки из анализа по CSS-селекторам
Примеры запросов агенту
- Проверь доступность страницы https://example.com по стандарту WCAG 2.2 AA.
- Сравни визуальное состояние staging и production через aqe visual test.
- Запусти тест адаптивной вёрстки для https://example.com на разных разрешениях экрана.
Как установить qe-visual-accessibility
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a claude-code2Вручную: положить файлы
~/.claude/skills/qe-visual-accessibility/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qe-visual-accessibility/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a codex2Вручную: положить файлы
.agents/skills/qe-visual-accessibility/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a cursor2Вручную: положить файлы
.cursor/skills/qe-visual-accessibility/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install proffesor-for-testing/agentic-qe assets/skills/qe-visual-accessibility2Вручную: положить файлы
.github/skills/qe-visual-accessibility/SKILL.md1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a gemini-cli2Командой платформы
gemini skills install https://github.com/proffesor-for-testing/agentic-qe --path assets/skills/qe-visual-accessibilityВручную: положить файлы
.devin/skills/qe-visual-accessibility/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qe-visual-accessibility
Как установить qe-visual-accessibility в Claude Code?
Выполните команду npx skills add proffesor-for-testing/agentic-qe --skill qe-visual-accessibility -a claude-code. Конфигурация скилла будет сохранена по пути ~/.claude/skills/qe-visual-accessibility/SKILL.md.
Что делает qe-visual-accessibility?
Скилл координирует агентов для поиска пиксельных различий на страницах, проверяет адаптивность макета и запускает аудит доступности по WCAG 2.2.
Какой браузерный движок нужен для работы?
Автоматизация использует движок Vibium из скилла qe-browser. Бинарный файл vibium ставится командой aqe init.
Исходный текст
SKILL.md · MIT
---
name: "qe-visual-accessibility"
description: "Captures and compares screenshots across viewports, runs axe-core accessibility scans, and detects visual regressions with pixel-diff analysis. Use when detecting UI regressions, validating responsive layouts, testing WCAG compliance, or ensuring visual consistency after CSS or component changes."
trust_tier: 3
validation:
schema_path: schemas/output.json
validator_path: scripts/validate-config.json
eval_path: evals/qe-visual-accessibility.yaml
---
# QE Visual Accessibility
## Purpose
Guide the use of v3's visual and accessibility testing capabilities including screenshot comparison, responsive design validation, and WCAG 2.2 compliance verification.
## Activation
- When testing visual appearance
- When validating responsive design
- When checking accessibility compliance
- When detecting visual regressions
- When testing cross-browser rendering
## Quick Start
```bash
# Visual regression test
aqe visual test --baseline production --current staging
# Responsive design test
aqe visual responsive --url https://example.com --viewports all
# Accessibility audit
aqe a11y audit --url https://example.com --standard wcag22-aa
# Cross-browser test
aqe visual cross-browser --url https://example.com --browsers chrome,firefox,safari
```
## Agent Workflow
```typescript
// Visual regression testing
Task("Run visual regression", `
Compare staging against production:
- Capture screenshots of key pages
- Detect pixel differences
- Flag significant visual changes
- Generate visual diff report
`, "qe-visual-tester")
// Accessibility audit
Task("Audit accessibility", `
Run WCAG 2.2 AA compliance audit:
- Check color contrast ratios
- Verify keyboard navigation
- Test screen reader compatibility
- Validate ARIA labels
Generate compliance report with fix suggestions.
`, "qe-accessibility-agent")
```
## Browser engine
All browser automation in this skill uses the **qe-browser** fleet skill (Vibium engine). See `.claude/skills/qe-browser/SKILL.md`. The `vibium` binary is installed by `aqe init`.
## Visual Testing Operations
### 1. Visual Regression (via qe-browser)
```bash
# Establish baselines for the pages we care about
for path in / /login /dashboard /settings; do
slug=$(echo "$path" | tr '/' '_' | sed 's/^_//' || echo root)
vibium go "https://production.example.com$path" && vibium wait load
node .claude/skills/qe-browser/scripts/visual-diff.js --name "baseline_${slug:-root}"
done
# Compare staging against those baselines
for path in / /login /dashboard /settings; do
slug=$(echo "$path" | tr '/' '_' | sed 's/^_//' || echo root)
vibium go "https://staging.example.com$path" && vibium wait load
node .claude/skills/qe-browser/scripts/visual-diff.js \
--name "baseline_${slug:-root}" --threshold 0.001 # 0.1% pixel diff
done
```
Ignore dynamic regions (timestamps, live counts) by scoping the diff to a selector that excludes them:
```bash
node .claude/skills/qe-browser/scripts/visual-diff.js \
--name hero --selector "main > .content"
```
Legacy programmatic TypeScript API (still available for tests that prefer it over shelling out):
```typescript
await visualTester.compareScreenshots({
baseline: {
source: 'production',
pages: ['/', '/login', '/dashboard', '/settings']
},
current: {
source: 'staging',
pages: ['/', '/login', '/dashboard', '/settings']
},
comparison: {
threshold: 0.1, // 0.1% pixel difference
antialiasing: true,
ignoreRegions: ['#dynamic-content', '.timestamp']
}
});
```
### 2. Responsive Testing
```typescript
await responsiveTester.test({
url: 'https://example.com',
viewports: [
{ name: 'mobile', width: 375, height: 667 },
{ name: 'tablet', width: 768, height: 1024 },
{ name: 'desktop', width: 1920, height: 1080 }
],
checks: {
layoutShift: true,
contentOverflow: true,
touchTargets: true,
fontScaling: true
}
});
```
### 3. Accessibility Audit
```typescript
await accessibilityAgent.audit({
url: 'https://example.com',
standard: 'WCAG22-AA',
checks: {
perceivable: {
colorContrast: true,
textAlternatives: true,
captions: true
},
operable: {
keyboardAccessible: true,
noTimingIssues: true,
navigable: true
},
understandable: {
readable: true,
predictable: true,
inputAssistance: true
},
robust: {
compatible: true,
parseErrors: true
}
}
});
```
### 4. Cross-Browser Testing
```typescript
await visualTester.crossBrowser({
url: 'https://example.com',
browsers: ['chrome', 'firefox', 'safari', 'edge'],
versions: 'latest-2',
comparisons: {
betweenBrowsers: true,
betweenVersions: true,
againstBaseline: true
}
});
```
## WCAG 2.2 Checklist
| Level | Criteria | Auto-Testable |
|-------|----------|---------------|
| A | Non-text Content | ✅ |
| A | Info and Relationships | Partial |
| A | Color Contrast (4.5:1) | ✅ |
| A | Keyboard Accessible | ✅ |
| A | Focus Visible | ✅ |
| AA | Reflow | ✅ |
| AA | Text Spacing | ✅ |
| AAA | Enhanced Contrast (7:1) | ✅ |
## Visual Test Report
```typescript
interface VisualReport {
summary: {
pagesCompared: number;
differencesFound: number;
passRate: number;
};
comparisons: {
page: string;
viewport: string;
baseline: string;
current: string;
diff: string;
diffPercentage: number;
status: 'pass' | 'fail' | 'review';
}[];
accessibility: {
violations: A11yViolation[];
passes: number;
incomplete: number;
score: number;
};
responsive: {
viewport: string;
issues: ResponsiveIssue[];
}[];
}
```
## Accessibility Report
```typescript
interface AccessibilityReport {
summary: {
score: number;
violations: number;
warnings: number;
passes: number;
};
violations: {
id: string;
impact: 'critical' | 'serious' | 'moderate' | 'minor';
description: string;
wcag: string[];
elements: {
selector: string;
html: string;
issue: string;
fix: string;
}[];
}[];
compliance: {
wcagLevel: 'A' | 'AA' | 'AAA';
criteriasMet: number;
criteriasTotal: number;
};
}
```
## CI/CD Integration
```yaml
visual_testing:
on_pr:
- capture_screenshots
- compare_to_baseline
- run_a11y_audit
thresholds:
visual_diff: 0.1
a11y_violations: 0
artifacts:
- screenshots/
- diffs/
- a11y-report.html
```
## Coordination
**Primary Agents**: qe-visual-tester, qe-accessibility-agent, qe-responsive-tester
**Coordinator**: qe-visual-coordinator
**Related Skills**: qe-test-execution, qe-quality-assessment
© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe