К основному содержанию
скилл CX Codex

playwright-frontend — скилл для Claude Code: установка

Скилл playwright-frontend для Claude Code помогает размечать UI-компоненты так, чтобы Playwright и ИИ-агенты находили их по устойчивым локаторам. Включается при создании или проверке компонентов.

MIT 426 установок ★ 422 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a claude-code
Открыть на GitHub

Что делает playwright-frontend

playwright-frontend задаёт правила разметки интерфейсов для автоматизации тестов и поиска элементов ИИ-агентами. Сначала нужно использовать семантическую HTML-разметку и доступные имена, а data-testid добавлять, когда роли, подписи и текст не помогают найти элемент однозначно.

Скилл описывает правила именования и уникальности атрибутов, а для элементов списка рекомендует использовать стабильный ключ сущности вместо индекса массива. Есть примеры для React, Vue, Angular и Svelte, в том числе централизация ID и удаление атрибутов в production. Если тест или агент уже использует data-testid, переименование этого атрибута ломает зависимость.

Какие задачи решает

  • подобрать локатор для UI-компонента
  • разметить кастомный виджет атрибутом data-testid
  • сделать ID элементов списка уникальными и стабильными
  • проверить разметку компонента перед написанием тестов

Примеры запросов агенту

  • Разметь компонент формы так, чтобы Playwright находил поля по доступным подписям.
  • Проверь компонент списка и предложи стабильные data-testid для его строк.
  • Добавь локаторы для этого виджета, если роли и текст не позволяют найти его однозначно.

Как установить playwright-frontend

1Через Skills CLI (Vercel)

npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a claude-code

2Вручную: положить файлы

~/.claude/skills/frontend/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/frontend/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о playwright-frontend

Как установить playwright-frontend в Claude Code?

Выполни npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a claude-code. Файл скилла находится по пути ~/.claude/skills/frontend/SKILL.md.

Что делает playwright-frontend?

Скилл описывает, как размечать UI, чтобы тесты и ИИ-агенты могли находить элементы. Он ставит семантическую разметку на первое место и задаёт правила для data-testid.

Как задавать data-testid для элементов списка?

Добавляй к ID стабильный ключ сущности, например user-row-${user.id}, а не индекс массива. Имя должно оставаться независимым от текста, локали, стилей и позиции в DOM.

Исходный текст

SKILL.md · MIT
---
name: playwright-frontend
description: For frontend engineers authoring UI — how to make components reliably locatable by tests and AI agents. Covers the official Playwright locator priority, semantic/accessible markup first, and how to add valid, unique, stable `data-testid` attributes (naming convention, uniqueness in lists, stability rules) for React, Vue, Angular, and Svelte. Use when writing or reviewing components, or when an agent needs durable locators.
license: MIT
metadata:
  author: testdino.com
  version: "1.0.0"
---

# Playwright Frontend (Authoring Locatable Markup)

> Audience: **frontend engineers writing the app** — the counterpart to the test-author guides in `core/`. Your job here is to expose a small, stable, machine-readable contract on the DOM so tests *and* AI agents can locate elements deterministically, without flakiness.

A `data-testid` is a **public API for your UI's automation layer**: once a test or agent depends on it, renaming it is a breaking change. Build accessible markup first, then add deliberate, well-named, unique, stable test IDs where automation needs a durable handle.

## Guide Index

| Topic | Guide |
|---|---|
| `data-testid` conventions (when, naming, uniqueness, stability) | [data-testid-conventions.md](data-testid-conventions.md) |
| Framework patterns (React, Vue, Angular, Svelte) + centralizing IDs + production stripping | [examples.md](examples.md) |

## Golden Rules

1. **Semantic HTML first** — give elements a real role/label/accessible name so `getByRole`/`getByLabel` work; then add test IDs.
2. **Add `data-testid` only where role, label and text fall short** — no-role custom widgets, scope containers, list rows, and dynamic or localized regions. A control `getByRole` already finds uniquely needs none.
3. **Name for global uniqueness** — `feature-component-element[-variant]`, `kebab-case`.
4. **In lists, suffix with a stable domain key, never the array index** — `user-row-${user.id}` ✅ / `user-row-${index}` ❌.
5. **Decouple the value from text, locale, styling, and DOM position** — those change; the test ID must not.
6. **Standardize on one attribute** — `data-testid` is Playwright's default `testIdAttribute`; don't mix `data-test`/`data-qa`.

## Related

- [core/locators.md](../core/locators.md) / [core/locator-strategy.md](../core/locator-strategy.md) — the consumer side: choosing locators when *writing tests*.
- Playwright official docs: [Locators](https://playwright.dev/docs/locators), [Best Practices](https://playwright.dev/docs/best-practices).

© testdino.com · MIT · testdino-hq/playwright-skill

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
frontend-app-builder официальный OpenAI Скилл frontend-app-builder для Codex проектирует и собирает интерфейсы приложений, сайтов и игр, затем проверяет их в браузере. Выполняет новую frontend-разработку и редизайн по явному запросу. CX Codex GP ChatGPT +1 252установок playwright-app-testing Expensify Скилл playwright-app-testing для Claude Code и Codex: браузерная автоматизация через Playwright. Запускает тесты UI после правок в фронтенде, проверяет работу интерфейса и помогает отловить баги в вёрстке и логике. CX Codex +1 ★ 5 104звёзд репо playwright-screenshot-inspector curiositech Скилл playwright-screenshot-inspector для визуального тестирования веб-интерфейсов: запускает Playwright в headless-режиме, делает скриншоты и анализирует их через мультимодальную модель. CX Codex +1 262установок playwright-best-practices currents.dev Скилл playwright-best-practices для Claude Code — справочник по архитектуре Playwright-тестов, селекторам и Page Object Model. Помогает разбирать флакующие тесты, мокировать API и проверять доступность. CX Codex +1 107 500установок frontend-visual-qa daymade Скилл frontend-visual-qa для Claude Code проверяет отрисованный интерфейс в браузере и проходит пользовательские сценарии. Запускается для визуального аудита сайтов, дашбордов и других уже собранных интерфейсов. CX Codex +1 664установок playwright-skill lackeyjb Скилл для написания и запуска Playwright-скриптов прямо в редакторе. Автоматически находит dev-серверы, делает скриншоты, проверяет адаптивность, тестирует логины и валидирует работу сайта. CX Codex +1 8 000установок

Из того же набора8

playwright-skill Скилл снабжает агента 79 справочниками по Playwright 1.64 на TypeScript и JavaScript. Помогает писать тесты, разбирать падения в CI, настраивать моки и устранять флаки-сценарии. CX Codex +1 6 200установок playwright-core Скилл playwright-core даёт готовые паттерны Playwright для сквозных тестов, API и моков в проектах на TypeScript и JavaScript. Пригодится при отладке упавших сценариев и настройке фикстур. CX Codex +1 1 100установок playwright-cli Скилл управляет браузером через команды playwright-cli: помогает проверять свои веб-приложения, делать снимки страниц и разбирать сбои. CX Codex +1 907установок playwright-pom Скилл playwright-pom для ИИ-агента с двумя гайдами по Page Object Model в Playwright: как строить page objects и когда вместо них лучше фикстуры или хелперы. CX Codex +1 674установок playwright-ci Скилл playwright-ci для Claude Code с готовыми конфигурациями CI/CD для Playwright: GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins и Docker. Закрывает пайплайн, когда тесты уже написаны, а он всё ещё падает. CX Codex +1 604установок playwright-qa Скилл playwright-qa помогает проектировать QA-проверки поверх Playwright, разбирать падения и переносить ручные тесты в автоматизированные спецификации. CX Codex +1 463установок playwright-migration Скилл playwright-migration для Claude Code содержит пошаговые руководства по переносу тестов с Cypress и Selenium на Playwright с таблицами команд и разбором архитектуры. CX Codex +1 454установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой