Проверка веб-приложения скриптами Playwright
Делает проверки локального веб-приложения скриптами Python Playwright: помощник поднимает и гасит серверы, агент осматривает страницу, кликает, снимает скриншоты и читает консоль. Для случаев, когда нужно проверить фронтенд или воспроизвести баг.
webapp-testing- Автор
- Anthropic
- Источник
- anthropics/skills/skills/webapp-testing @ e4bb5d9
- Лицензия
- Apache-2.0 · Copyright 2026 Anthropic, PBC.
Об этом скилле
Что делает
Скилл учит агента проверять локальное веб-приложение небольшими скриптами на Python Playwright (синхронный API, Chromium без окна). Подход выбирается по дереву решений. Статический HTML агент читает ради селекторов и открывает по file://. С динамическим приложением работает по схеме «сначала разведка, потом действие»: открыть страницу, дождаться networkidle, снять скриншот или выгрузить DOM, взять селекторы из того, что действительно отрисовалось, и только потом кликать и заполнять. Смотреть DOM до networkidle — та ошибка, от которой скилл предостерегает.
scripts/with_server.py поднимает серверы, нужные приложению. Он запускает одну или несколько команд, ждёт, пока каждый порт начнёт принимать соединения (по умолчанию 30 секунд, --timeout), выполняет ваш скрипт и гасит серверы, так что в скрипте Playwright остаётся только работа с браузером. Агент вызывает его с --help и пользуется им как чёрным ящиком. В examples/ три образца: element_discovery.py перечисляет кнопки, ссылки и поля ввода, static_html_automation.py заполняет форму в локальном файле, console_logging.py собирает сообщения консоли. Они сохраняют файлы в /tmp/ и /mnt/user-data/outputs/ — это пути песочницы Anthropic, у себя их нужно поменять.
Нужен Python с пакетом playwright и его Chromium; как их поставить, скилл не объясняет.
Когда включать и когда не надо
Чтобы проверить, что изменение во фронтенде работает, воспроизвести баг интерфейса, снять скриншоты или прочитать ошибки консоли у приложения, которое запускается локально.
После него остаются одноразовые скрипты, а не набор тестов: ни спецификаций @playwright/test, ни прогона в CI.
Как поставить и вызвать
Команда установки ниже скачивает всю папку. Агент подхватывает скилл, когда нужно проверить интерфейс. Вызвать вручную:
- Claude Code:
/webapp-testingили попросить скилл по имени. - Codex:
$webapp-testing. - Cursor: наберите
/в чате Agent и выберитеwebapp-testing.
Пример: /webapp-testing Запусти приложение через npm run dev на порту 5173, войди демо-пользователем и проверь, что дашборд открывается без ошибок в консоли.
Чем отличается от похожих
Скилл E2E-тесты на Playwright из нашего каталога пишет спецификации @playwright/test, которые остаются в репозитории и идут в CI. Управление браузером через Playwright CLI ведёт браузер командами playwright-cli по ссылкам на элементы из снимков страницы, без скриптов; ему нужны Node и npx. Скилл Тесты в браузере через Chrome DevTools MCP смотрит на живой Chrome через MCP-сервер. Этот скилл — по скрипту на Python на каждую проверку и помощник для серверов.
Установка
Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
curl -fsSL --create-dirs -o ~/.claude/skills/webapp-testing/SKILL.md https://anymodel.org/en/skills/anthropic/webapp-testing/SKILL.md -o ~/.claude/skills/webapp-testing/LICENSE.txt https://anymodel.org/en/skills/anthropic/webapp-testing/LICENSE.txt -o ~/.claude/skills/webapp-testing/examples/console_logging.py https://anymodel.org/en/skills/anthropic/webapp-testing/examples/console_logging.py -o ~/.claude/skills/webapp-testing/examples/element_discovery.py https://anymodel.org/en/skills/anthropic/webapp-testing/examples/element_discovery.py -o ~/.claude/skills/webapp-testing/examples/static_html_automation.py https://anymodel.org/en/skills/anthropic/webapp-testing/examples/static_html_automation.py -o ~/.claude/skills/webapp-testing/scripts/with_server.py https://anymodel.org/en/skills/anthropic/webapp-testing/scripts/with_server.py && chmod +x ~/.claude/skills/webapp-testing/scripts/with_server.py
curl -fsSL --create-dirs -o ~/.agents/skills/webapp-testing/SKILL.md https://anymodel.org/en/skills/anthropic/webapp-testing/SKILL.md -o ~/.agents/skills/webapp-testing/LICENSE.txt https://anymodel.org/en/skills/anthropic/webapp-testing/LICENSE.txt -o ~/.agents/skills/webapp-testing/examples/console_logging.py https://anymodel.org/en/skills/anthropic/webapp-testing/examples/console_logging.py -o ~/.agents/skills/webapp-testing/examples/element_discovery.py https://anymodel.org/en/skills/anthropic/webapp-testing/examples/element_discovery.py -o ~/.agents/skills/webapp-testing/examples/static_html_automation.py https://anymodel.org/en/skills/anthropic/webapp-testing/examples/static_html_automation.py -o ~/.agents/skills/webapp-testing/scripts/with_server.py https://anymodel.org/en/skills/anthropic/webapp-testing/scripts/with_server.py && chmod +x ~/.agents/skills/webapp-testing/scripts/with_server.py
foreach ($f in 'SKILL.md','LICENSE.txt','examples/console_logging.py','examples/element_discovery.py','examples/static_html_automation.py','scripts/with_server.py') { $p = Join-Path "$HOME\.claude\skills\webapp-testing" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/anthropic/webapp-testing/$f" -UseBasicParsing -OutFile $p }foreach ($f in 'SKILL.md','LICENSE.txt','examples/console_logging.py','examples/element_discovery.py','examples/static_html_automation.py','scripts/with_server.py') { $p = Join-Path "$HOME\.agents\skills\webapp-testing" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/anthropic/webapp-testing/$f" -UseBasicParsing -OutFile $p }Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/anthropic/webapp-testing/SKILL.md
SKILL.md
Web Application Testing
To test local web applications, write native Python Playwright scripts.
Helper Scripts Available:
scripts/with_server.py- Manages server lifecycle (supports multiple servers)
Always run scripts with --help first to see usage. DO NOT read the source until you try running the script first and find that a customized solution is abslutely necessary. These scripts can be very large and thus pollute your context window. They exist to be called directly as black-box scripts rather than ingested into your context window.
Decision Tree: Choosing Your Approach
User task → Is it static HTML?
├─ Yes → Read HTML file directly to identify selectors
│ ├─ Success → Write Playwright script using selectors
│ └─ Fails/Incomplete → Treat as dynamic (below)
│
└─ No (dynamic webapp) → Is the server already running?
├─ No → Run: python scripts/with_server.py --help
│ Then use the helper + write simplified Playwright script
│
└─ Yes → Reconnaissance-then-action:
1. Navigate and wait for networkidle
2. Take screenshot or inspect DOM
3. Identify selectors from rendered state
4. Execute actions with discovered selectors
Example: Using with_server.py
To start a server, run --help first, then use the helper:
Single server:
python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py
Multiple servers (e.g., backend + frontend):
python scripts/with_server.py \
--server "cd backend && python server.py" --port 3000 \
--server "cd frontend && npm run dev" --port 5173 \
-- python your_automation.py
To create an automation script, include only Playwright logic (servers are managed automatically):
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
page = browser.new_page()
page.goto('http://localhost:5173') # Server already running and ready
page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
# ... your automation logic
browser.close()
Reconnaissance-Then-Action Pattern
Inspect rendered DOM:
page.screenshot(path='/tmp/inspect.png', full_page=True) content = page.content() page.locator('button').all()Identify selectors from inspection results
Execute actions using discovered selectors
Common Pitfall
❌ Don't inspect the DOM before waiting for networkidle on dynamic apps
✅ Do wait for page.wait_for_load_state('networkidle') before inspection
Best Practices
- Use bundled scripts as black boxes - To accomplish a task, consider whether one of the scripts available in
scripts/can help. These scripts handle common, complex workflows reliably without cluttering the context window. Use--helpto see usage, then invoke directly. - Use
sync_playwright()for synchronous scripts - Always close the browser when done
- Use descriptive selectors:
text=,role=, CSS selectors, or IDs - Add appropriate waits:
page.wait_for_selector()orpage.wait_for_timeout()
Reference Files
- examples/ - Examples showing common patterns:
element_discovery.py- Discovering buttons, links, and inputs on a pagestatic_html_automation.py- Using file:// URLs for local HTMLconsole_logging.py- Capturing console logs during automation
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel