К основному содержанию
плагин

cypress — плагин для Claude Code: тесты Cypress и установка

cypress — плагин для Claude Code, который помогает создавать, обновлять и исправлять тесты Cypress. Скиллы подключаются при работе с тестовым кодом, а интеграция с Cypress Cloud даёт доступ к данным о запусках.

MIT ★ 49 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install cypress@claude-community
Открыть на GitHub

Что делает cypress

Плагин добавляет скиллы для работы с тестами Cypress и подключения к Cypress Cloud. cypress-author помогает писать и чинить тесты, cypress-explain разбирает существующий тестовый код, а cypress-docs ищет сведения о Cypress.

cypress-tap управляет запущенной сессией Cypress в open mode: запускает спеки, проверяет результаты и помогает разбирать сбои. cypress-cloud-cli исследует запуски, тесты, ошибки, скриншоты и данные Test Replay в Cypress Cloud. MCP-сервер Cypress Cloud подключает помощник к данным о состоянии приложения. Подключение MCP по умолчанию использует OAuth; для Personal Access Token нужно изменить .mcp.json.

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

  • создать тест Cypress
  • исправить сломанный тест
  • разобрать существующий тест
  • исследовать сбой в Cypress Cloud

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

  • Создай тест Cypress для этой страницы.
  • Найди причину сбоя в этом тесте и исправь его.
  • Разбери этот запуск в Cypress Cloud и покажи ошибки.

Как установить cypress

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install cypress@claude-community

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

Вопросы о cypress

Как установить cypress в Claude Code?

Сначала добавь маркетплейс командой /plugin marketplace add anthropics/claude-plugins-community, затем установи плагин командой /plugin install cypress@claude-community.

Что делает cypress?

Плагин добавляет скиллы для создания, обновления и исправления тестов Cypress, анализа существующих тестов и исследования запусков в Cypress Cloud.

Что нужно для работы cypress?

Для работы нужны Cypress и инструмент для ИИ-кодинга. Подключение к Cypress Cloud MCP использует OAuth по умолчанию; для Personal Access Token требуется изменить .mcp.json.

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

SKILL.md · MIT
<p align="center">
  <img src="./assets/cypress-logotype-dark.svg#gh-light-mode-only" alt="Cypress" width="240" />
  <img src="./assets/cypress-logotype.svg#gh-dark-mode-only" alt="Cypress" width="240" />
</p>

<p align="center">
  <a href="https://on.cypress.io/discord">
    <img src="https://img.shields.io/badge/chat-on%20Discord-brightgreen" alt="Discord chat" />
  </a>
</p>

# ✨ Cypress AI Toolkit

Open-source Cypress AI skills, built by the Cypress team. Works with Claude, Cursor, GitHub Copilot, and more.

Your AI tool is capable. It just does not know Cypress the way you do. The toolkit fixes that with skills, context, and guidance built by the team that built Cypress.

Cypress also ships AI capabilities in the App and Cypress Cloud - such as [`cy.prompt()`](https://docs.cypress.io/api/commands/prompt), Studio AI, Cloud MCP, Test Intent and Error Summaries, and UI Coverage test generation. Learn more in the [Cypress AI documentation](https://docs.cypress.io/cloud/features/cypress-ai-features).

## The problem this solves

AI tools can work with Cypress. What they struggle with is applying it consistently and correctly.

Without guidance, AI tools fall back on generic patterns — underusing the Cypress API, misapplying selectors, skipping best practices that experienced Cypress developers internalize over time. The result is output that technically runs but that you can't rely on.

The Cypress AI Toolkit gives your AI tools the Cypress-specific context they need to produce output you can actually build on — consistently, across your team and your workflows.

## What's in the toolkit

### Model Context Protocol (MCP)

The Cypress Cloud MCP server connects your AI coding assistants directly to Cypress Cloud, giving them access to data regarding your application's health and stability.

More information about the Cypress Cloud MCP is available [here](https://docs.cypress.io/cloud/integrations/cloud-mcp).

Use the first-class installer for your agent when one exists:

| Tool | When to use |
| --- | --- |
| [Cypress Claude Connector](https://docs.cypress.io/cloud/integrations/cloud-mcp#Claude-Desktop) | For Claude Desktop app users |
| [Cypress Cursor Plugin](#plugin) | For Cursor users |
| [Cypress VS Code Extension](https://marketplace.visualstudio.com/items?itemName=Cypress-io.vscode-cypress-cloud-mcp) (`Cypress-io.vscode-cypress-cloud-mcp`) | For VS Code and GitHub Copilot users |

_Note:_ The MCP connection will utilize OAuth by default. If you would prefer to use a Personal Access Token (PAT) you will need to adjust the `.mcp.json` file for your agent.

### Skills

Skills are instruction sets your AI tool loads to apply Cypress-specific knowledge when generating or reviewing test code. They fill the gap between what an AI learned during training and what current, well-written Cypress tests actually look like.

Five skills are available now:

- **[`cypress-author`](./skills/README.md#cypress-author)** — Improves how AI tools create, update, and fix Cypress tests. Use it when you're writing new tests or fixing broken ones.
- **[`cypress-explain`](./skills/README.md#cypress-explain)** — Helps you understand, describe, and critique existing tests. Use it when auditing a suite, onboarding a new team member, or investigating a brittle test before rewriting it.
- **[`cypress-docs`](./skills/README.md#cypress-docs)** - Helps your agent research and retrieve information about Cypress more efficiently and reliably.
- **[`cypress-tap`](./skills/README.md#cypress-tap)** — Drives a running Cypress open-mode session to run specs, inspect results, diagnose failures, and query the app under test without GUI interaction.
- **[`cypress-cloud-cli`](./skills/README.md#cypress-cloud-cli)** — Investigates Cypress Cloud runs, tests, failures, screenshots, and Test Replay data through the Cypress Cloud CLI.

Skills work with any AI tool that accepts custom instructions, including Claude, Cursor, and GitHub Copilot.

See the [skills documentation](./skills/README.md) for installation instructions, example prompts, and troubleshooting.

### What's coming

We're building toward a broader toolkit.

The community will help shape what gets prioritized. If you're already unlocking AI-powered Cypress workflows, we want to hear how. [Open an issue](https://github.com/cypress-io/ai-toolkit/issues) or [open a PR](https://github.com/cypress-io/ai-toolkit/pulls).

## Getting started

### Plugin

The Cypress AI toolkit is published as a plugin for installation into your agent. This is the easiest way to install and configure the various capabilities in this package and also enables an auto-update capability.

_Note: Our listing in the Cursor official plugin marketplace is currently pending. This README will be updated once it is available. Until then, this repository can be cloned and installed as a local plugin in your agent of choice._

#### Claude

The plugin is published in the Claude Community Plugins marketplace - see the the [instructions here](https://github.com/anthropics/claude-plugins-community#using-this-marketplace) for configuring your Claude instance to use this marketplace. Once the marketplace is configured you can search for the `cypress` plugin.

### Manual Installation

If you're using another agent or prefer to pick-and-choose you can pick the portions of this repository you want.

1. Install the skills using command-line tools

 * [`skills`](https://skills.sh/) package:
   ```sh
   npx skills add cypress-io/ai-toolkit
   ```
  
  * [`GitHub CLI`](https://cli.github.com/manual/gh_skill):
    ```sh
    gh skill install cypress-io/ai-toolkit
    ```

2. Prompt your AI tool as you normally would. The skills will activate automatically when relevant, or invoke one directly with a slash command (e.g. `/cypress-author`).

    For manual installation, example prompts, and more, see the [skills documentation](./skills/README.md) or the [Cypress AI Skills docs](https://docs.cypress.io/app/tooling/ai-skills).

3. Connect Cypress Cloud MCP with the installer for your agent (see the [MCP table](#model-context-protocol-mcp) above). You can also copy the configuration from [`mcp/`](./mcp/) or follow the [configuration instructions here](https://docs.cypress.io/cloud/integrations/cloud-mcp).

## Who this is for

This toolkit is for Cypress developers who use AI coding tools and want consistent, reliable output — not just code that runs.

It's the right fit if you want your AI tool to:

- Follow Cypress conventions and best practices without being told every time
- Produce workflows you can repeat and build on, not just one-off completions
- Behave consistently across your team, regardless of who's prompting

You do not need AI expertise to use it. You need Cypress and an AI coding tool.

## Contributing

We welcome contributions of all kinds: new skills, improvements to existing ones, bug reports, and ideas.

If you've built something that makes AI tools smarter about Cypress, this is the right place to share it.

Read the [contributing guide](./CONTRIBUTING.md) to get started.

## Releases
### PR Checks
Any change to a skill should have a corresponding semver update to the `version` frontmatter field in the `SKILL.md` file.

Changes to any functional toolkit content (skills and mcp, not documentation for example) should update the `version` metadata under `.cursor-plugin` and `.claude-plugin` so that plugin marketplaces can see and update accordingly.

### Post-PR Actions
After an update with skill changes is merged run `gh skill publish` **from the `main` branch**. Preview changes with `--dry-run`. Version to match the plugin version above - this likely will *not* match the version of individual skills, but should be thought of as a "package" version.

## License

[MIT](./LICENSE)

© cypress-io · MIT · cypress-io/ai-toolkit

Похожие плагины

Все плагины по теме «Тесты и QA» →
cypress-defect-tracking-cursorrules-prompt-file PatrickJS Правило cypress-defect-tracking-cursorrules-prompt-file для Cursor, которое превращает агента в QA-инженера: пишет тесты Cypress с тегами команд, категорий и case ID и собирает отчёты через qa-shadow-report. CX Codex +1 ★ 41 178звёзд репо cypress-playwright-setup patricio0312rev Скилл cypress-playwright-setup для Claude Code, Codex, Cursor и других агентов, который разворачивает E2E-тестирование на Cypress или Playwright: page objects, фикстуры и CI-интеграция. CX Codex +1 313установок cypress-flake-fixer официальный github Скилл cypress-flake-fixer ищет в существующем наборе тестов Cypress шаблоны, из-за которых тесты падают через раз, и правит их. Пригодится перед обновлением до Cypress 15 или 16. CX Codex +1 ★ 41 430звёзд репо cypress-integration-testing-cursorrules-prompt-file PatrickJS Правило cypress-integration-testing-cursorrules-prompt-file для Cursor задаёт генерацию интеграционных тестов Cypress: проверяет UI и API через cy.intercept и селекторы data-testid. CX Codex +1 ★ 41 178звёзд репо cypress-expert 0xfurai Субагент cypress-expert помогает проектировать и отлаживать сквозные тесты на Cypress: от фикстур и пользовательских команд до разбора нестабильных проверок. CX Codex ★ 1 029звёзд репо cypress-skill TestMu AI Генерирует production-grade E2E и component-тесты на JavaScript или TypeScript. Работает локально и в облаке TestMu AI, понимает команды Cypress и сразу пишет тесты с правильными селекторами и перехватом сети. CX Codex +1 264установок

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

cypress-author Скилл cypress-author для Claude Code создаёт, обновляет и чинит тесты Cypress — E2E и компонентные. Включается, когда агент получает задачу написать тесты и не знает, с чего начать. CX Codex +1 10 000установок cypress-docs Скилл cypress-docs для Claude Code: заставляет агента искать в официальной документации Cypress, а не сочинять по памяти. Находит точный синтаксис команды и поведение в конкретной версии. CX Codex +1 9 100установок cypress-explain Скилл cypress-explain разбирает сквозные и компонентные тесты Cypress, объясняет вызовы команд и проводит ревью кода без внесения правок в файлы проекта. CX Codex +1 8 900установок cypress-tap Скилл cypress-tap управляет запущенной сессией Cypress open через CLI без интерфейса. Помогает прогонять тесты, читать логи репортёра и проверять DOM прямо из чата с агентом. CX Codex +1 3 300установок cypress-cloud-cli Скилл cypress-cloud-cli для Claude Code и других агентов подключает CLI cy-cloud для разбора упавших и нестабильных тестов Cypress Cloud прямо в чате. CX Codex +1 2 200установок Cypress Cloud MCP Сервер связывает ИИ-ассистентов с Cypress Cloud и передаёт им отчёты о запусках тестов и доступности интерфейса. Пригодится при разборе падений сборок прямо в коде. CX Codex +1 ★ 49звёзд репо

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

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