# cypress-tap

Управляет запущенной сессией Cypress open через CLI без интерфейса. Помогает прогонять тесты, читать логи репортёра и проверять DOM прямо из чата с агентом.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2700 установок · ★ 47
- Автор: cypress-io
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/cypress-io/ai-toolkit/tree/HEAD/skills/cypress-tap/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/cypress-tap

## Что делает

Скилл даёт агенту набор инструкций для управления активной сессией `cypress open`. Вместо ручных кликов в графическом окне браузера агент вызывает `cypress tap run` для запуска e2e или компонентных тестов, опрашивает `status` до получения свежего вердикта и считывает протокол прогона через `reporter`. Команды `dom`, `aria` и `pin` позволяют инспектировать дерево доступности и перематывать состояние приложения к сохранённым снапшотам.

Запуск тестов асинхронный: команда `run` лишь подтверждает постановку в очередь, а не завершение проверки. Поэтому агент отслеживает изменение метки времени `startedAt` и ждёт финального статуса `passed` или `failed`. Для работы с несколькими сессиями поддерживаются флаги `--session <pid>`, `--json` и `--timeout <ms>`.

Попытка запустить скилл в Firefox или WebKit приведёт к ошибке: поддерживается только семейство Chromium (Electron, Chrome, Edge). Перед вызовом команд необходимо предварительно запустить dev-сервер приложения и саму сессию `cypress open`. Для разовых фоновых прогонов в CI скилл не подходит, для этого существует штатная команда `cypress run`.

## Требования
- Работает с: Chrome

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cypress-io/ai-toolkit --skill cypress-tap -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cypress-io/ai-toolkit --skill cypress-tap -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cypress-io/ai-toolkit --skill cypress-tap -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cypress-io/ai-toolkit cypress-tap
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cypress-io/ai-toolkit --skill cypress-tap -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/cypress-io/ai-toolkit --path skills/cypress-tap
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add cypress-io/ai-toolkit --skill cypress-tap -a opencode
```

### Claude.ai

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

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

## Когда брать
- запустить выбранный e2e-тест в открытом окне Cypress
- прочитать ошибки падения и сетевые заглушки из отчёта
- инспектировать состояние DOM и селекторы без GUI
- перемотать кадр приложения к снапшоту конкретного шага

## Примеры запросов агенту
- Прогони тест cypress/e2e/login.cy.ts через cypress tap и покажи ошибки, если упал
- Проверь активные сессии через cypress tap sessions и выведи статус последней
- Посмотри разметку страницы через cypress tap dom и найди селектор кнопки отправки

## Похожие
- [cypress](https://affpapa.org/nevibecode/skills/claude-mpm-team-cypress.md) — скилл · 653 установки
- [cypress-automation](https://affpapa.org/nevibecode/skills/cypress-automation.md) — скилл · 1000 установок
- [cypress-defect-tracking-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/cypress-defect-tracking-cursorrules-prompt-file.md) — правило · ★ 41011
- [cypress-flake-fixer](https://affpapa.org/nevibecode/skills/cypress-flake-fixer.md) — скилл · ★ 40418
- [e2e-testing-automation](https://affpapa.org/nevibecode/skills/e2e-testing-automation.md) — скилл · 689 установок
- [clerk-testing](https://affpapa.org/nevibecode/skills/clerk-testing.md) — скилл · 46300 установок

Из того же набора: [cypress-io/ai-toolkit](https://affpapa.org/nevibecode/by/cypress-io/ai-toolkit.md) — 5 карточек

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

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