cypress-explain — скилл для Claude Code: что делает и как установить
Разбирает сквозные и компонентные тесты Cypress, объясняет вызовы команд и проводит ревью кода без внесения правок в файлы проекта.
npx skills add cypress-io/ai-toolkit --skill cypress-explain -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/cypress-explain/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cypress-explain/
1Через Skills CLI (Vercel)
npx skills add cypress-io/ai-toolkit --skill cypress-explain -a codex2Вручную: положить файлы
.agents/skills/cypress-explain/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cypress-io/ai-toolkit --skill cypress-explain -a cursor2Вручную: положить файлы
.cursor/skills/cypress-explain/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cypress-io/ai-toolkit cypress-explain2Вручную: положить файлы
.github/skills/cypress-explain/SKILL.md1Через Skills CLI (Vercel)
npx skills add cypress-io/ai-toolkit --skill cypress-explain -a gemini-cli2Командой платформы
gemini skills install https://github.com/cypress-io/ai-toolkit --path skills/cypress-explainВручную: положить файлы
.devin/skills/cypress-explain/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cypress-io/ai-toolkit --skill cypress-explain -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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