Playwright Best Practices Skill
57 справочных файлов по тестам Playwright на TypeScript: агент берет из них нужный по задаче, от локаторов до шардирования в CI
- 417 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл состоит из текстовых справочников, ничего не запускает и не обращается к сети
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/playwright-best-practices-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл состоит из текстовых справочников, ничего не запускает и не обращается к сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл от команды Currents собирает практики написания, отладки и сопровождения тестов Playwright на TypeScript. Основной файл `SKILL.md` сопоставляет то, что вы делаете, с нужными справочниками, поэтому агент читает только подходящий раздел и оставляет остальную базу закрытой. Всего в скилле 57 справочных документов в восьми папках. Ядро составляют структура набора тестов, локаторы, ожидания и проверки, фикстуры, тестовые данные, конфигурация и зависимости между проектами. Рядом лежат разделы об отладке и нестабильных тестах, паттерны для API, компонентных, визуальных и тестов доступности, формы, перетаскивание, GraphQL, canvas и WebGL, Electron и расширения браузера. Отдельно разобраны безопасность (XSS, CSRF, авторизация), производительность через Web Vitals и Lighthouse, мобильные устройства, часы и часовые пояса, WebSocket, iframe и service worker. В папках для фреймворков есть советы по React, Angular, Vue и Next.js, а в разделе CI/CD — GitHub Actions, GitLab, Docker, параллельный запуск и шардирование, отчеты и покрытие.
Для кого. QA-инженерам и разработчикам, которые пишут e2e и компонентные тесты на Playwright и хотят, чтобы агент следовал общепринятым паттернам и не придумывал структуру на ходу.
Подходит, если
- Тест падает через раз, и агент разбирает причины нестабильности по справочнику о flaky-тестах
- Страницы покрывают объектами страниц или фикстурами, и надо выбрать одно из двух
- К набору добавляют тесты доступности с axe-core и проверку клавиатурной навигации
- Тестируют сценарии с попапами, OAuth, загрузкой файлов или подменой даты и времени
- Конвейер в GitHub Actions или GitLab собирают с шардированием и отчетами
Не подходит, если
- Тесты написаны на Python, Java или .NET: примеры в скилле даны на TypeScript
- Проект на Cypress или Selenium без перехода на Playwright
- Агент должен сам открыть браузер и пройти страницу: скилл хранит справочники и браузер не запускает
- Тестов в проекте еще нет, и сначала нужно выбрать инструмент: скилл учит писать тесты на Playwright и фреймворки не сравнивает
Пример запроса к агенту
Тест логина падает в CI в одном из пяти запусков: найди причину нестабильности и перепиши ожидания и локаторы по лучшим практикам PlaywrightОграничения
Скилл состоит из текстовых справочников и ничего не запускает: ни браузеры, ни сами тесты, ни проверки. Примеры написаны для Playwright на TypeScript, для других языков привязки примеры придется переводить. API и параметры конфигурации сверяйте с официальной документацией вашей версии Playwright. Подгрузка идет по описанию задачи, и если агент выбрал не тот раздел, ему стоит указать файл вручную, например `core/locators.md`. Все 57 документов нужны не каждому проекту: для небольшого набора хватает ядра. Последний коммит репозитория относится к июлю 2026 года.
Как отключить. Удалите папку скилла `playwright-best-practices` из каталога скиллов агента, например из `.claude/skills/`. Скилл ничего не пишет в проект и не меняет конфигурацию, поэтому других следов не остается.
Частые вопросы
Как поставить Playwright Best Practices Skill в Claude Code?
Выполните `npx skills add https://github.com/currents-dev/playwright-best-practices-skill`. Отдельно упоминать скилл в запросах не нужно: агент подключает его, когда видит задачу про Playwright.
Что входит в скилл?
57 справочных документов в восьми папках: ядро, отладка, паттерны тестирования, продвинутые темы, браузерные API, архитектура, фреймворки и CI/CD. Папка `playwright-best-practices` содержит их все.
Чем он отличается от Playwright MCP?
MCP-сервер Playwright управляет браузером. Этот скилл ничего не запускает, он учит агента писать и чинить тесты по практикам, а выбор паттерна, структуры и CI оставляет вам.
Подходит ли он для компонентных тестов и Electron?
Да. Для них есть отдельные документы: `component-testing.md`, `electron.md` и `browser-extensions.md` для расширений. Они лежат в папке `testing-patterns`.
Как использовать его для нестабильных тестов?
Опишите агенту симптом, например «тест падает через раз в CI». Скилл направит его к `flaky-tests.md`, где разобраны выявление, диагностика, исправление и карантин нестабильных тестов, и к документам про ожидания.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл, с которым агент пишет и запускает скрипты Playwright: тесты страниц, формы, скриншоты, проверки ссылок
Руководства для агента, который пишет и чинит тесты Playwright: выбор локаторов, ожидания и диагностика сбоев в CI
Шаблон проекта Playwright на TypeScript с правилами и 17 скиллами, чтобы Claude Code, Codex и Cursor писали тесты по стандарту
Семь QA-агентов и десять скиллов для автотестов: Playwright на TypeScript, Selenium на Java, API, доступность и ISTQB.
Playwright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
Скилл проверки кода агента в настоящем браузере: читает ваши изменения, составляет план теста и прогоняет его через Playwright с вашими куки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Playwright Best Practices Skill (эта карточка) | нет | 417 | |
| TestDino Playwright Skill | нет | 412 | руководства от TestDino для написания и починки тестов; здесь шире охват: безопасность, Electron, CI и шардирование |
| Playwright Skill | нет | 3 266 | скилл запускает скрипты Playwright и снимает страницы; этот только учит писать тесты по практикам |
Коротко о README
Страница начинается с баннера и описания, затем дает команду установки и список задач, при которых скилл срабатывает. Основной объем занимают таблицы по папкам с названиями справочников и подсказками, для чего каждый нужен.
Бейдж для README
Исходный SKILL.md
--- name: playwright-best-practices description: Use when writing Playwright tests, fixing flaky tests, debugging failures, implementing Page Object Model, configuring CI/CD, optimizing performance, mocking APIs, handling authentication or OAuth, testing accessibility (axe-core), file uploads/downloads, date/time mocking, WebSockets, geolocation, permissions, multi-tab/popup flows, mobile/responsive layouts, touch gestures, GraphQL, error handling, offline mode, multi-user collaboration, third-party services (payments, email verification), console error monitoring, global setup/teardown, test annotations (skip, fixme, slow), test tags (@smoke, @fast, @critical, filtering with --grep), project dependencies, security testing (XSS, CSRF, auth), performance budgets (Web Vitals, Lighthouse), iframes, component testing, canvas/WebGL, service workers/PWA, test coverage, i18n/localization, Electron apps, or browser extension testing. Covers E2E, component, API, visual, accessibility, security, Electron, and extension testing. license: MIT metadata: author: currents.dev version: "1.2" --- # Playwright Best Practices This skill provides comprehensive guidance for all aspects of Playwright test development, from writing new tests to debugging and maintaining existing test suites. ## Activity-Based Reference Guide Consult these references based on what you're doing: ### Writing New Tests **When to use**: Creating new test files, writing test cases, implementing test scenarios | Activity | Reference Files | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | **Writing E2E tests** | [test-suite-structure.md](core/test-suite-structure.md), [locators.md](core/locators.md), [assertions-waiting.md](core/assertions-waiting.md) | | **Writing component tests** | [component-testing.md](testing-patterns/component-testing.md), [test-suite-structure.md](core/test-suite-structure.md) | | **Writing API tests** | [api-testing.md](testing-patterns/api-testing.md), [test-suite-structure.md](core/test-suite-structure.md) | | **Writing GraphQL tests** | [graphql-testing.md](testing-patterns/graphql-testing.md), [api-testing.md](testing-patterns/api-testing.md) | | **Writing visual regression tests** | [visual-regression.md](testing-patterns/visual-regression.md), [canvas-webgl.md](testing-patterns/canvas-webgl.md) | | **Structuring test code with POM** | [page-object-model.md](core/page-object-model.md), [test-suite-structure.md](core/test-suite-structure.md) | | **Setting up test data/fixtures** | [fixtures-hooks.md](core/fixtures-hooks.md), [test-data.md](core/test-data.md) | | **Handling authentication** | [authentication.md](advanced/authentication.md), [authentication-flows.md](advanced/authentication-flows.md) | | **Testing date/time features** | [clock-mocking.md](advanced/clock-mocking.md) | | **Testing file upload/download** | [file-operations.md](testing-patterns/file-operations.md), [file-upload-download.md](testing-patterns/file-upload-download.md) | | **Testing forms/validation** | [forms-validation.md](testing-patterns/forms-validation.md) | | **Testing drag and drop** | [drag-drop.md](testing-patterns/drag-drop.md) | | **Testing accessibility** | [accessibility.md](testing-patterns/accessibility.md) | | **Testing security (XSS, CSRF)** | [security-testing.md](testing-patterns/security-testing.md) | | **Using test annotations** | [annotations.md](core/annotations.md) | | **Using test tags** | [test-tags.md](core/test-tags.md) | | **Testing iframes** | [iframes.md](browser-apis/iframes.md) | | **Testing canvas/WebGL** | [canvas-webgl.md](testing-patterns/canvas-webgl.md) | | **Internationalization (i18n)** | [i18n.md](testing-patterns/i18n.md) | | **Testing Electron apps** | [electron.md](testing-patterns/electron.md) | | **Testing browser extensions** | [browser-extensions.md](testing-patterns/browser-extensions.md) | ### Mobile & Responsive Testing **When to use**: Testing mobile devices, touch interactions, responsive layouts | Activity | Reference Files |