Управление браузером через Playwright CLI

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

ТестированиеПак: Скиллы OpenAI147 строкplaywright
Автор
Источник
openai/skills/skills/.curated/playwright @ 49f948f
Лицензия
Apache-2.0

Об этом скилле

Что делает

Скилл даёт агенту управлять настоящим браузером из терминала через playwright-cli, по одной команде: открыть страницу, снять снапшот, выполнить действие с элементом, посмотреть снова. Снапшот выдаёт каждому элементу короткую ссылку вроде e3, и click, fill, select или check работают с этими ссылками. После перехода, модального окна или смены вкладки агент снимает снапшот заново, потому что ссылки устаревают, и без причины не обходит их через eval или run-code. Скилл сохраняет скриншоты и PDF, читает консоль и сетевой журнал, пишет трейсы, работает с несколькими вкладками и разводит именованные сессии (--session или PLAYWRIGHT_CLI_SESSION). Файлы складываются в output/playwright/. Спеки @playwright/test пишутся только по вашей просьбе.

scripts/playwright_cli.sh запускает npx --yes --package @playwright/cli playwright-cli, поэтому глобальная установка не нужна, и передаёт переменную сессии дальше. В references/cli.md — основные команды, в references/workflows.md — типовые сценарии и конфиг playwright-cli.json. NOTICE.txt сообщает, что скилл переработан из скилла playwright-cli от Microsoft.

Когда включать и когда не надо

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

Для тестов, которые живут в репозитории и гоняются в CI, он не подходит: по умолчанию скилл работает командами CLI, а не спеками тестов.

Как поставить и вызвать

Команда установки ниже скачивает всю папку. Нужен Node.js с npx; без него агент остановится и попросит поставить Node. SKILL.md ищет обёртку в $CODEX_HOME/skills/playwright/; в Claude Code или Cursor укажите агенту папку, куда поставили скилл, или поставьте CLI глобально: npm install -g @playwright/cli@latest. Агент сам подхватывает скилл по описанию. Вызвать вручную:

  • Claude Code: /playwright или попросить скилл по имени.
  • Codex: $playwright.
  • Cursor: наберите / в чате Agent и выберите playwright.

Пример: /playwright Открой localhost:3000, зарегистрируйся с тестовой почтой и сделай скриншот после каждого шага.

OpenAI пометила репозиторий openai/skills устаревшим; наша копия зафиксирована на одном из его коммитов, а новой версии этого скилла в openai/plugins на ноябрь 2026 года нет.

Чем отличается от похожих

В скилле Проверка веб-приложения скриптами Playwright агент пишет скрипты Playwright на Python, а with_server.py поднимает серверы приложения; этот скилл шлёт команды CLI по одной и скриптов не оставляет. E2E-тесты на Playwright — это спеки @playwright/test, которые остаются в репозитории. Тесты в браузере через Chrome DevTools MCP работают через MCP-сервер, а не CLI, и добавляют трейсы производительности с LCP, CLS и INP.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

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

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/playwright/SKILL.md https://anymodel.org/en/skills/openai/playwright/SKILL.md -o ~/.claude/skills/playwright/LICENSE.txt https://anymodel.org/en/skills/openai/playwright/LICENSE.txt -o ~/.claude/skills/playwright/NOTICE.txt https://anymodel.org/en/skills/openai/playwright/NOTICE.txt -o ~/.claude/skills/playwright/agents/openai.yaml https://anymodel.org/en/skills/openai/playwright/agents/openai.yaml -o ~/.claude/skills/playwright/assets/playwright-small.svg https://anymodel.org/en/skills/openai/playwright/assets/playwright-small.svg -o ~/.claude/skills/playwright/assets/playwright.png https://anymodel.org/en/skills/openai/playwright/assets/playwright.png -o ~/.claude/skills/playwright/references/cli.md https://anymodel.org/en/skills/openai/playwright/references/cli.md -o ~/.claude/skills/playwright/references/workflows.md https://anymodel.org/en/skills/openai/playwright/references/workflows.md -o ~/.claude/skills/playwright/scripts/playwright_cli.sh https://anymodel.org/en/skills/openai/playwright/scripts/playwright_cli.sh && chmod +x ~/.claude/skills/playwright/scripts/playwright_cli.sh
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/playwright/SKILL.md https://anymodel.org/en/skills/openai/playwright/SKILL.md -o ~/.agents/skills/playwright/LICENSE.txt https://anymodel.org/en/skills/openai/playwright/LICENSE.txt -o ~/.agents/skills/playwright/NOTICE.txt https://anymodel.org/en/skills/openai/playwright/NOTICE.txt -o ~/.agents/skills/playwright/agents/openai.yaml https://anymodel.org/en/skills/openai/playwright/agents/openai.yaml -o ~/.agents/skills/playwright/assets/playwright-small.svg https://anymodel.org/en/skills/openai/playwright/assets/playwright-small.svg -o ~/.agents/skills/playwright/assets/playwright.png https://anymodel.org/en/skills/openai/playwright/assets/playwright.png -o ~/.agents/skills/playwright/references/cli.md https://anymodel.org/en/skills/openai/playwright/references/cli.md -o ~/.agents/skills/playwright/references/workflows.md https://anymodel.org/en/skills/openai/playwright/references/workflows.md -o ~/.agents/skills/playwright/scripts/playwright_cli.sh https://anymodel.org/en/skills/openai/playwright/scripts/playwright_cli.sh && chmod +x ~/.agents/skills/playwright/scripts/playwright_cli.sh
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE.txt','NOTICE.txt','agents/openai.yaml','assets/playwright-small.svg','assets/playwright.png','references/cli.md','references/workflows.md','scripts/playwright_cli.sh') { $p = Join-Path "$HOME\.claude\skills\playwright" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/openai/playwright/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE.txt','NOTICE.txt','agents/openai.yaml','assets/playwright-small.svg','assets/playwright.png','references/cli.md','references/workflows.md','scripts/playwright_cli.sh') { $p = Join-Path "$HOME\.agents\skills\playwright" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/openai/playwright/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/openai/playwright/SKILL.md

SKILL.md

Исходник

Playwright CLI Skill

Drive a real browser from the terminal using playwright-cli. Prefer the bundled wrapper script so the CLI works even when it is not globally installed. Treat this skill as CLI-first automation. Do not pivot to @playwright/test unless the user explicitly asks for test files.

Prerequisite check (required)

Before proposing commands, check whether npx is available (the wrapper depends on it):

command -v npx >/dev/null 2>&1

If it is not available, pause and ask the user to install Node.js/npm (which provides npx). Provide these steps verbatim:

# Verify Node/npm are installed
node --version
npm --version

# If missing, install Node.js/npm, then:
npm install -g @playwright/cli@latest
playwright-cli --help

Once npx is present, proceed with the wrapper script. A global install of playwright-cli is optional.

Skill path (set once)

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export PWCLI="$CODEX_HOME/skills/playwright/scripts/playwright_cli.sh"

User-scoped skills install under $CODEX_HOME/skills (default: ~/.codex/skills).

Quick start

Use the wrapper script:

"$PWCLI" open https://playwright.dev --headed
"$PWCLI" snapshot
"$PWCLI" click e15
"$PWCLI" type "Playwright"
"$PWCLI" press Enter
"$PWCLI" screenshot

If the user prefers a global install, this is also valid:

npm install -g @playwright/cli@latest
playwright-cli --help

Core workflow

  1. Open the page.
  2. Snapshot to get stable element refs.
  3. Interact using refs from the latest snapshot.
  4. Re-snapshot after navigation or significant DOM changes.
  5. Capture artifacts (screenshot, pdf, traces) when useful.

Minimal loop:

"$PWCLI" open https://example.com
"$PWCLI" snapshot
"$PWCLI" click e3
"$PWCLI" snapshot

When to snapshot again

Snapshot again after:

  • navigation
  • clicking elements that change the UI substantially
  • opening/closing modals or menus
  • tab switches

Refs can go stale. When a command fails due to a missing ref, snapshot again.

Form fill and submit

"$PWCLI" open https://example.com/form
"$PWCLI" snapshot
"$PWCLI" fill e1 "[email protected]"
"$PWCLI" fill e2 "password123"
"$PWCLI" click e3
"$PWCLI" snapshot

Debug a UI flow with traces

"$PWCLI" open https://example.com --headed
"$PWCLI" tracing-start
# ...interactions...
"$PWCLI" tracing-stop

Multi-tab work

"$PWCLI" tab-new https://example.com
"$PWCLI" tab-list
"$PWCLI" tab-select 0
"$PWCLI" snapshot

Wrapper script

The wrapper script uses npx --package @playwright/cli playwright-cli so the CLI can run without a global install:

"$PWCLI" --help

Prefer the wrapper unless the repository already standardizes on a global install.

References

Open only what you need:

  • CLI command reference: references/cli.md
  • Practical workflows and troubleshooting: references/workflows.md

Guardrails

  • Always snapshot before referencing element ids like e12.
  • Re-snapshot when refs seem stale.
  • Prefer explicit commands over eval and run-code unless needed.
  • When you do not have a fresh snapshot, use placeholder refs like eX and say why; do not bypass refs with run-code.
  • Use --headed when a visual check will help.
  • When capturing artifacts in this repo, use output/playwright/ and avoid introducing new top-level artifact folders.
  • Default to CLI commands and workflows, not Playwright test specs.

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

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

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

Приложения на ASP.NET Core

Делает работу с ASP.NET Core по актуальным правилам: выбор между Blazor, Razor Pages, MVC и Minimal APIs, Program.cs и порядок middleware, авторизация, EF Core, тесты, переход на .NET 10. Для случаев, когда вы создаёте, ревьюите или обновляете приложение.

Приложения для ChatGPT на Apps SDK

Делает приложения для ChatGPT на Apps SDK: сначала читает документацию OpenAI, выбирает тип приложения, планирует MCP-инструменты, берёт официальный пример или заготовку на Node, проверяет в режиме разработчика. Для случаев, когда приложение живёт в ChatGPT.

CLI по документации API

Делает постоянный CLI по документации API, OpenAPI, curl-запросам или скрипту: JSON на выходе, doctor и dry-run, безопасная авторизация, установка в PATH и скилл-компаньон. Для случаев, когда агент раз за разом ходит в один сервис самодельными запросами.

Измеримая цель до начала работы

Делает из расплывчатого намерения одну измеримую цель с проверкой, границами и условием остановки и заводит её через get_goal и create_goal. Для случаев, когда перед долгой работой агента надо договориться, что считать «готово».

Разбор комментариев к PR на GitHub

Делает пронумерованный список всех комментариев, ревью и построчных тредов PR текущей ветки через GraphQL-скрипт на gh и правит только выбранные вами. Для случаев, когда в PR накопились замечания и вы хотите сами решить, что исправлять.

Починка упавших проверок GitHub Actions

Делает разбор упавших проверок GitHub Actions в PR: через gh скачивает логи, вырезает кусок с ошибкой и составляет план исправления, а код меняет только после одобрения. Для случаев, когда CI в PR красный и сначала нужна причина.

Ноутбуки Jupyter

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

Задачи и проекты в Linear

Делает работу с задачами, проектами и циклами Linear через его MCP-сервер в строгом порядке: настройка, рамки, чтение, потом запись, с примерами сценариев для триажа, спринтов и релизов. Для случаев, когда агент должен читать или менять Linear по ходу задачи.

Деплой на Netlify

Делает деплой проекта на Netlify через `npx netlify`: проверяет вход, привязывает папку к сайту по Git-remote или создаёт новый, собирает локально и отдаёт адрес превью или прода. Для случаев, когда сайт нужно выложить на Netlify со своей машины.

Деплой на Render

Делает деплой приложения на Render из Git: пишет и проверяет Blueprint render.yaml с сервисами, базами и секретами или создаёт один сервис через MCP-сервер Render, затем смотрит статус и логи. Для случаев, когда приложению нужен хостинг на Render.

Ревью безопасности по стеку

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

Модель угроз репозитория

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

Ошибки и события в Sentry

Делает выборку issues и событий из Sentry через CLI sentry, ничего не меняя: свежие ошибки прода, детали issue и события, ИИ-разбор причины, с маскировкой персональных данных. Для случаев, когда нужно понять по Sentry, что ломается на проде.

Деплой на Vercel

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

Контекст дизайна из Figma MCP

Делает код из фрейма Figma через MCP-сервер: контекст дизайна, метаданные, скриншот, затем перевод на компоненты и токены проекта; описывает настройку сервера в Codex. Для случаев, когда нужно подключить Figma MCP или сверстать фрейм по ссылке.

Работа с Figma через use_figma

Делает обязательную подготовку перед каждым вызовом use_figma: правила Plugin API о return, страницах, цветах, шрифтах, ID узлов и работе малыми проверяемыми шагами. Для случаев, когда агент создаёт или правит что-то внутри файла Figma.

Вёрстка по макету Figma

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

Макет в Figma из приложения

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

Дизайн-система в Figma из кода

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

Связка компонентов Figma с кодом

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

Правила дизайн-системы для Figma

Делает файл правил для вёрстки по Figma — в CLAUDE.md, AGENTS.md или правила Cursor — по шаблону Figma и разбору кодовой базы. Для случаев, когда агента нужно один раз настроить на регулярную работу с макетами в этом репозитории.

Новый файл в Figma

Делает пустой файл Figma или доску FigJam в черновиках, выбирая тарифный план через whoami, и возвращает ключ и ссылку. Для случаев, когда следующему шагу с Figma нужен новый файл для записи.