playwright-frontend — скилл для Claude Code: установка
Скилл playwright-frontend для Claude Code помогает размечать UI-компоненты так, чтобы Playwright и ИИ-агенты находили их по устойчивым локаторам. Включается при создании или проверке компонентов.
MIT 426 установок ★ 422 обновлён 2026-10-12
npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/frontend/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/frontend/
1Через Skills CLI (Vercel)
npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a codex2Вручную: положить файлы
.agents/skills/frontend/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a cursor2Вручную: положить файлы
.cursor/skills/frontend/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install testdino-hq/playwright-skill frontend2Вручную: положить файлы
.github/skills/frontend/SKILL.md1Через Skills CLI (Vercel)
npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a gemini-cli2Командой платформы
gemini skills install https://github.com/testdino-hq/playwright-skill --path frontendВручную: положить файлы
.devin/skills/frontend/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add testdino-hq/playwright-skill --skill playwright-frontend -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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