web-qa-exploration — скилл для Claude Code
Скилл web-qa-exploration проверяет веб-приложение через Playwright: проходит заданные сценарии, ищет ошибки и собирает отчёт со скриншотами и шагами воспроизведения.
Apache-2.0 1 установок ★ 1 обновлён 2026-01-13
npx skills add bryonjacob/aug --skill web-qa-exploration -a claude-codeЧто делает web-qa-exploration
Скилл исследует страницы и пользовательские сценарии в заданных границах. Он проверяет формы, навигацию, состояния интерфейса, доступность и обработку ошибок: например, пробует пустую отправку, пограничные значения и переход по прямой ссылке. Найденным проблемам присваиваются категория и серьёзность.
Результаты сохраняются в report.md и report.json, а скриншоты — в /tmp/webqa/{session-id}/screenshots/. Для каждого дефекта предусмотрены шаги воспроизведения, ожидаемое и фактическое поведение, а также пример теста Playwright. Анализ ограничен заданными точками маршрута и занимает 2–5 минут на точку; скилл не исправляет найденные проблемы, поэтому исправления придётся планировать отдельно.
Какие задачи решает
- проверить формы на пустые и пограничные значения
- найти сбои при обновлении страницы и переходе назад
- проверить состояния интерфейса и клавиатурную навигацию
- собрать дефекты со скриншотами и шагами воспроизведения
- подготовить примеры тестов Playwright для найденных ошибок
Примеры запросов агенту
- Проверь сценарий регистрации: найди проблемы в форме и сохрани отчёт со скриншотами.
- Исследуй заданные страницы, включая переход назад и обновление, и запиши найденные ошибки.
- Проверь доступность и обработку ошибочных параметров URL, затем предложи тесты Playwright для дефектов.
Как установить web-qa-exploration
1Через Skills CLI (Vercel)
npx skills add bryonjacob/aug --skill web-qa-exploration -a claude-code2Вручную: положить файлы
~/.claude/skills/web-qa-exploration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/web-qa-exploration/
1Через Skills CLI (Vercel)
npx skills add bryonjacob/aug --skill web-qa-exploration -a codex2Вручную: положить файлы
.agents/skills/web-qa-exploration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bryonjacob/aug --skill web-qa-exploration -a cursor2Вручную: положить файлы
.cursor/skills/web-qa-exploration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bryonjacob/aug aug-dev/skills/web-qa-exploration2Вручную: положить файлы
.github/skills/web-qa-exploration/SKILL.md1Через Skills CLI (Vercel)
npx skills add bryonjacob/aug --skill web-qa-exploration -a gemini-cli2Командой платформы
gemini skills install https://github.com/bryonjacob/aug --path aug-dev/skills/web-qa-explorationВручную: положить файлы
.devin/skills/web-qa-exploration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bryonjacob/aug --skill web-qa-exploration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о web-qa-exploration
Как установить web-qa-exploration в Claude Code?
Выполните npx skills add bryonjacob/aug --skill web-qa-exploration -a claude-code. Файл скилла находится по пути ~/.claude/skills/web-qa-exploration/SKILL.md.
Что делает web-qa-exploration?
Он исследует веб-приложение через Playwright, проверяет заданные сценарии и оформляет найденные проблемы в отчётах со скриншотами и шагами воспроизведения.
Какие результаты создаёт скилл?
Он формирует report.md с отсортированными по серьёзности проблемами и report.json для автоматизации. Скриншоты сохраняются в каталоге сессии.
Исходный текст
SKILL.md · Apache-2.0
---
name: web-qa-exploration
description: Perform exploratory QA testing on web applications using Playwright. Navigate flows, analyze pages, find issues, and generate actionable reports with evidence.
---
# Web QA Exploration
Autonomous exploratory testing using Playwright to analyze web application flows, identify issues, and generate actionable reports.
## Core Principles
1. **Thoroughness over speed** - Analyze each page state fully
2. **Break things intentionally** - Try edge cases, unexpected inputs, unusual navigation
3. **Document everything** - When in doubt, capture it
4. **Stay focused** - Follow defined waypoints; don't wander
5. **Fail gracefully** - If stuck, document and move on
## Working Directory
```
/tmp/webqa/{session-id}/
session.md # Session context and scope
report.md # Human-readable findings
report.json # Machine-readable for automation
screenshots/ # Visual evidence
metadata.json # Session info, status
```
All ephemeral. Output feeds into `/plan-chat` or `/plan-breakdown`.
## Analysis Checklist
At each waypoint, systematically check:
### Visual & Layout
- Content fully visible (no overflow, cutoff)
- Proper spacing and alignment
- Images/icons load correctly
- No layout shifts after load
### Navigation & State
- **Back button** - Does it preserve state?
- **Refresh** - Does page recover?
- **Deep link** - Can URL be shared/bookmarked?
### Forms & Inputs
- **Empty submission** - Validation fires?
- **Boundary values** - Max length, min/max numbers
- **Special characters** - `<script>`, quotes, unicode
- **Whitespace** - Leading/trailing, only spaces
- **Tab order** - Keyboard navigation logical
- **Error messages** - Clear, positioned correctly
### Interactions
- **Double-click** - Rapid clicking on submit
- **Keyboard shortcuts** - Enter, Escape behavior
- **Focus states** - Visible indicators
- **Disabled states** - Buttons during submission
### Accessibility (basic)
- Heading structure (h1-h6 hierarchy)
- Form labels present
- Color contrast (visual check)
- Alt text on images
### Error Handling
- Network failure behavior
- Timeout handling
- Invalid URL parameters
## Issue Documentation
Each issue needs:
- **id**: ISSUE-001
- **severity**: critical | high | medium | low | note
- **category**: bug | ux | accessibility | edge-case | visual
- **page**: /path/to/page
- **title**: Short description
- **description**: Detailed explanation
- **steps_to_reproduce**: Ordered list
- **expected**: What should happen
- **actual**: What actually happens
- **screenshot**: Path to evidence
- **suggested_test**: Playwright test code
## Severity Guidelines
- **Critical**: Crashes, data loss, security issue, flow blocker
- **High**: Feature broken, significant UX problem
- **Medium**: Edge case failures, minor UX issues
- **Low**: Polish issues, minor visual glitches
- **Note**: Observations, suggestions, not bugs
## Scope Control
- Only explore pages/states within defined scope
- Time-box analysis (2-5 minutes per waypoint)
- Don't attempt to fix issues during exploration
### When Stuck
1. Document with maximum detail
2. Take screenshot
3. Attempt one workaround (refresh, re-navigate)
4. If still blocked, mark waypoint as "blocked" and skip
5. Continue from next accessible waypoint
## Output
### report.md
Summary table with severity counts, then issues ordered by severity. Each issue includes description, steps, expected/actual, screenshot, and suggested Playwright test.
### metadata.json
```json
{
"session_id": "{session-id}",
"scope": "{DESCRIPTION}",
"status": "complete",
"waypoints_total": 5,
"waypoints_completed": 5,
"issues": { "critical": 0, "high": 1, "medium": 3, "low": 2, "note": 2 }
}
```
## Integration
**Feeds into:**
- `/plan-chat` - When issues need architectural discussion
- `/plan-breakdown` - When ready to create fix tasks directly
## Quality Checklist
- [ ] All waypoints visited or documented as blocked
- [ ] Each issue has severity, category, description
- [ ] Screenshots captured for visual issues
- [ ] Steps to reproduce provided
- [ ] Suggested Playwright tests included
- [ ] Summary statistics accurate
© bryonjacob · Apache-2.0 · bryonjacob/aug