Проверка веб-приложения скриптами Playwright

Делает проверки локального веб-приложения скриптами Python Playwright: помощник поднимает и гасит серверы, агент осматривает страницу, кликает, снимает скриншоты и читает консоль. Для случаев, когда нужно проверить фронтенд или воспроизвести баг.

ТестированиеПак: Скиллы Anthropic96 строкwebapp-testing
Автор
Источник
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 подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
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
Codex, Cursor — macOS, Linux
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
Claude Code — Windows PowerShell
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 }
Codex, Cursor — Windows PowerShell
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

  1. Inspect rendered DOM:

    page.screenshot(path='/tmp/inspect.png', full_page=True)
    content = page.content()
    page.locator('button').all()
    
  2. Identify selectors from inspection results

  3. 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 --help to 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() or page.wait_for_timeout()

Reference Files

  • examples/ - Examples showing common patterns:
    • element_discovery.py - Discovering buttons, links, and inputs on a page
    • static_html_automation.py - Using file:// URLs for local HTML
    • console_logging.py - Capturing console logs during automation

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Anthropic

Создание MCP-сервера

Делает MCP-сервер для внешнего API на TypeScript или Python: инструменты, схемы, пагинация, ошибки, проверка и прогон оценки через Claude. Для случаев, когда API или сервис нужно отдать агентам как инструменты MCP.

Создание скиллов с проверкой на тестах

Делает новый скилл или правит старый, проверяет его субагентами против контрольного прогона, показывает результаты и цифры на странице просмотра и подбирает описание. Для случаев, когда скилл нужно измерить, а не только написать.

Выразительный фронтенд-дизайн

Делает для нового интерфейса визуальное решение из мира продукта: короткий план цветов, шрифтов и композиции, сверенный с брифом и типичной ИИ-эстетикой до кода. Для случаев, когда страница или экран не должны выглядеть шаблонно.

PDF: чтение, заполнение, создание

Делает с PDF всё основное: текст и таблицы, склейка, разрезание, пароль, распознавание сканов, новые файлы, а формы заполняет скриптами с проверкой полей и рамок. Для случаев, когда нужно прочитать, заполнить или собрать PDF.

Документы Word (.docx)

Делает документы Word: новые собирает через docx-js, готовые правит прямо в XML, добавляет рецензирование и комментарии скриптами, потом проверяет и смотрит результат картинками. Для случаев, когда на входе или на выходе .docx или .dotx.

Таблицы Excel (.xlsx)

Делает таблицы Excel через openpyxl с живыми формулами, пересчитывает их в LibreOffice с отчётом об ошибках в JSON и соблюдает правила финансовых моделей. Для случаев, когда результат работы — сам файл таблицы: .xlsx, .xlsm или .csv.

Презентации PowerPoint (.pptx)

Делает презентации: новые собирает в pptxgenjs на теме и макетах, шаблоны правит в XML скриптами для текста, миниатюр, копий слайдов и проверки, каждый слайд смотрит картинкой. Для случаев, когда нужно создать, править или прочитать .pptx или .potx.

Справочник по Claude API для агента

Делает код для Claude API по справочнику Anthropic: SDK на семи языках и cURL, модели и цены, инструменты, кэширование, Managed Agents, процедуры миграции, экономии и оценок. Для случаев, когда код вызывает Claude или переходит на новую модель.

Генеративная графика на p5.js

Делает генеративную графику на p5.js: короткий манифест, затем алгоритм с зерном на одной HTML-странице с ползунками, переходом по зёрнам и скачиванием PNG. Для случаев, когда нужны поля течений, частицы или другая графика из кода.

Совместное написание документов

Делает написание документа процессом из трёх этапов: сбор контекста с вопросами, работа по разделам с вариантами на выбор и проверка на субагенте, который видит только текст. Для случаев, когда пишется спецификация, предложение или документ о решении.