# maestro-e2e

Скилл для написания и отладки E2E-тестов на Maestro: логины, регистрация, навигация, диалоги разрешений. Работает с iOS, Android, Flutter, React Native и вебом.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 533 установки · ★ 8
- Автор: raphaelbarbosaqwerty
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/raphaelbarbosaqwerty/maestro-dev-skills/tree/HEAD/SKILL.md
- Обновлён: 2026-02-05
- HTML: https://affpapa.org/nevibecode/skills/maestro-e2e

## Что делает

Скилл подключает к агенту справочник по Maestro: структура YAML-тестов, appId, переменные окружения, больше 40 команд, селекторы по id и тексту, ассерты, жесты. Отдельные файлы правил разбирают платформы — Android с ADB и эмуляторами, iOS с автоскрытием диалогов и симуляторами, Flutter через Semantics, React Native через testID и accessibilityLabel, веб через Chromium.

Есть разделы про параметры и синтаксис `${}`, условное выполнение, вложенные переиспользуемые флоу через `runFlow`, скрипты на GraalJS, ожидания и повторы для нестабильных тестов. Плюс отладка через Maestro Studio, скриншоты и запись видео, интеграция с GitHub Actions, GitLab CI и Maestro Cloud.

Скилл читает правила по требованию: при работе с нативными диалогами разрешений подгружается `rules/permissions.md`, для Flutter — `rules/platforms/flutter.md`. Поэтому в контекст попадает только нужное. Сначала стоит проверить, что Maestro установлен в системе — сам скилл его не ставит, только объясняет, как это сделать на macOS, Linux и Windows.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/maestro-e2e/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/maestro-e2e/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/maestro-e2e/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/maestro-e2e/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install raphaelbarbosaqwerty/maestro-dev-skills maestro-e2e
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/maestro-e2e/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/raphaelbarbosaqwerty/maestro-dev-skills
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/maestro-e2e/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add raphaelbarbosaqwerty/maestro-dev-skills --skill maestro-e2e -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/raphaelbarbosaqwerty/maestro-dev-skills/tree/HEAD/SKILL.md

## Когда брать
- написать E2E-тест на вход в приложение
- разобраться с диалогами разрешений на камере и геолокации
- найти элемент по id или тексту в дереве UI
- починить падающий тест из-за анимации
- вынести повторяющиеся шаги в переиспользуемый флоу

## Примеры запросов агенту
- Напиши E2E-тест Maestro на логин и переход на главный экран
- Почему падает assertVisible после тапа — помоги отладить
- Сделай subflow для ввода телефона и переиспользуй его в двух тестах

## Похожие
- [argent-qa-e2e](https://affpapa.org/nevibecode/skills/argent-qa-e2e.md) — скилл · 979 установок
- [e2e](https://affpapa.org/nevibecode/skills/e2e.md) — скилл · 1200 установок
- [argent-create-e2e](https://affpapa.org/nevibecode/skills/argent-create-e2e.md) — скилл · 979 установок
- [vitest-midscene-e2e](https://affpapa.org/nevibecode/skills/vitest-midscene-e2e.md) — скилл · 2100 установок
- [ios-simulator](https://affpapa.org/nevibecode/skills/ios-simulator.md) — скилл · 5200 установок
- [e2e-playwright-testing](https://affpapa.org/nevibecode/skills/e2e-playwright-testing.md) — скилл · 796 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md