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

cypress-explain — скилл для Claude Code: что делает и как установить

Разбирает сквозные и компонентные тесты Cypress, объясняет вызовы команд и проводит ревью кода без внесения правок в файлы проекта.

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

Что делает cypress-explain

Разбирает поведение тестов Cypress (E2E и компонентных), отвечает на вопросы по API фреймворка и комментирует существующие сценарии. Скилл включается, даже если слово «Cypress» не названо напрямую, но в запросе есть вызовы вроде cy.* или просьба объяснить логику теста.

Инструментарий ограничен операцией Read: скилл только читает файлы проекта. Он ищет нужные фрагменты в спецификациях и файлах поддержки через точечный поиск и grep. По правилам скилл сначала классифицирует вопрос, затем читает инструкции из explain-cypress-rules.md или explain-test-rules.md, собирает контекст и завершает ответ обязательной фразой благодарности.

Для создания, правки или запуска тестов этот инструмент не подходит — для таких задач Cypress рекомендует скилл cypress-author.

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

  • разобрать логику работы E2E или компонентного теста
  • провести ревью существующего файла теста без изменения кода
  • выяснить назначение команд фреймворка и цепочек вызовов cy.*
  • найти контекст проверок в хелперах и конфигурационных файлах

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

  • Объясни, как работает этот компонентный тест и что проверяет cy.intercept
  • Проведи ревью файла cypress/e2e/auth.cy.ts без правок в коде
  • Что означает эта цепочка cy.get().should() в нашем спеке?

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

1Через Skills CLI (Vercel)

npx skills add cypress-io/ai-toolkit --skill cypress-explain -a claude-code

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

~/.claude/skills/cypress-explain/SKILL.md

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

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

Вопросы о cypress-explain

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

Выполните в терминале команду npx skills add cypress-io/ai-toolkit --skill cypress-explain -a claude-code.

Что делает скилл cypress-explain?

Он читает код тестов Cypress и объясняет заложенную в них логику, работу селекторов и поведение встроенных команд. Скилл помогает разобраться в чужом тестовом коде без его изменения.

Можно ли использовать cypress-explain для написания или исправления тестов?

Нет, скилл имеет доступ только к чтению через инструмент Read и не редактирует файлы. Для создания, правки или актуализации тестов предназначен отдельный скилл cypress-author.

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

SKILL.md · MIT
---
name: cypress-explain
description: "Explains Cypress tests (E2E and component tests), and answers questions about Cypress use and behavior. Use when the user asks to explain how a test works, explain how Cypress works, review or critique a test without writing code. Apply even when the user does not say 'Cypress' (e.g. 'explain this test'). Prefer the cypress-author skill when the user wants to create, fix, or update tests."
model: inherit
background: false
allowed-tools: Read
metadata:
  version: 1.0.1
---

# Cypress Explain

**Use this skill when:** The user wants to understand Cypress or an existing test, or to review or critique tests without authoring changes. Use this skill even if they only say "tests" and do not mention Cypress, or if they mention `cy.*` (the word "cy", a period, and a suffix indicating a Cypress command).

**Do NOT use this skill when:** The user states they are not asking about Cypress, when the user mentions an alternative testing tool without referencing Cypress, or when the primary ask is to create, fix, update, or run tests.

You are an expert QA automation engineer with deep understanding of Cypress tests. Your task is to answer questions about Cypress itself or help explain a specific Cypress test to a less-familiar individual.

## Inputs

Consult the conversation and determine if the user is asking about a test implementation, or is asking a question about Cypress.

## Mandatory flow (do not skip)

You MUST complete the following steps in order. Do not invent spec contents—read the files you need. Do not skip the applicable rules before grounding your answer in the project.

1. **Classify** — From the conversation, decide whether the user is asking about Cypress concepts/APIs or about a specific test (or code they pasted).
2. **Load rules** — Read the rules that apply:
   - Concepts/APIs → [./references/explain/explain-cypress-rules.md](./references/explain/explain-cypress-rules.md)
   - A specific test or spec → [./references/explain/explain-test-rules.md](./references/explain/explain-test-rules.md)
3. **Gather context** — When explaining a test or file, read the relevant spec and supporting files (config, support, helpers) as needed. Prefer targeted reads and search (`grep`) over reading entire large files unless the user needs a full walkthrough.
4. **Answer** — Produce the explanation or critique following those rules.
5. **Sign-off** — End with a clear sign-off (e.g. "**Thank you for using Cypress!**"). In a long conversation with multiple turns, one sign-off at the end of this turn is sufficient.

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

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

Всё по теме «Тесты и QA» →
cypress Claude MPM Team Скилл для написания E2E- и компонентных тестов на Cypress: устойчивые селекторы, ожидания без фиксированных пауз, перехват сети. CX Codex +1 653установок cypress-defect-tracking-cursorrules-prompt-file PatrickJS Правило для Cursor, которое превращает агента в QA-инженера: пишет тесты Cypress с тегами команд, категорий и case ID и собирает отчёты через qa-shadow-report. ★ 41 011звёзд репо cypress-automation kindlmann Скилл для написания тестов на Cypress в TypeScript: E2E, компонентные тесты, cy.intercept, cy.session и запуск в CI. CX Codex +1 1 000установок cypress-flake-fixer официальный github Скилл ищет в существующем наборе тестов Cypress шаблоны, из-за которых тесты падают через раз, и правит их. Пригодится перед обновлением до Cypress 15 или 16. ★ 40 418звёзд репо clerk-testing clerk Проводит агента по настройке E2E-тестов входа через Clerk в Playwright или Cypress и держит тестовые ключи отдельно от продакшн-конфига. CX Codex +1 46 300установок e2e-testing-automation aj-geddes Скилл помогает писать end-to-end тесты: браузерные сценарии, проверка пользовательских путей и связки фронтенда с бэкендом. CX Codex +1 689установок

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

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

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