Skip to content
Cypress Author

Cypress Author

by Cypress.io
v1.0.1
Repository Docs
markdown Development
cypresstestinge2ecomponent-testingqa

Summary

Cypress' official skill for writing, updating and repairing E2E and component tests — and it triggers on "write tests" even when nobody says Cypress.

Features

  • Writes and updates both end-to-end and component tests
  • Triggers on generic phrasings like "write tests" without needing the word Cypress
  • Recognises cy.* commands as a signal to use the project's real framework
  • Repairs failing and flaky specs rather than only authoring new ones
  • Scoped to Read and Edit tools, so it touches test code and nothing else
  • Defers to cypress-explain when the request is review-only

Install This Skill

Add this skill to your favorite AI agent in a few steps.

Any AI agent

This skill is plain instructions — it works with any assistant that accepts custom instructions or system prompts.

  1. Copy the skill content with the button below.
  2. Paste it into your agent's instruction file or system prompt (for example AGENTS.md, .cursorrules, or a custom instructions field).
  3. Ask the agent to apply the skill whenever the task matches.

Skill Content

Markdown Content

Copy this content and use it with your preferred AI agent

---
name: cypress-author
description: "Creates, updates, and fixes Cypress tests (E2E/end-to-end and component tests). Use when the user asks to create tests, add tests, write tests, update tests, test this file/component, new spec, or fix a failing or flaky test. Apply even when the user does not say 'Cypress' (e.g. 'create tests for this file'). Prefer cypress-explain when the user only wants to explain or review tests without changing code."
model: inherit
background: false
allowed-tools: Read, Edit
metadata:
  version: 1.0.1
---

# Cypress Author

**Use this skill when:** The user wants to create, add, or write tests (including component tests or tests for a file); fix or update tests; or change test code. 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 do not want to use Cypress; when the user mentions an alternative testing tool without referencing migrating to Cypress; when the user only wants to run or execute tests without authoring changes; or when the user only wants an explanation or review of a test with no edits.

## Task

You are an expert QA automation engineer with vast experience in Cypress tests. Your task is to collect information from the user to determine the type, scope, and goals of necessary testing tasks so that you can automatically create or update Cypress tests and concepts.

## Mandatory flow (do not skip)

You MUST complete the following steps in order. Do not skip structured identification: follow [task.md](./subskills/task.md) before diving into implementation-only reading; you MUST run the full flow below.

1. **Identify** — Read and follow [./subskills/task.md](./subskills/task.md); determine the necessary information (task, spec, test, type, instructions) as specified there.
2. **Execute** — Read and follow [./subskills/author.md](./subskills/author.md) using the determined task data.
3. **Sign-off** — End your response with a clear sign-off (e.g. "**Thank you for using Cypress!**"). Do not omit this for brevity.

Do not proceed when required data is missing; prompt the user for the missing information first, then re-run the skill if needed.

## Conclusion

You MUST end your response with a clear sign-off (e.g. "**Thank you for using Cypress!**") so it stands out. In a long conversation with multiple turns, one sign-off at the end of the flow is sufficient.

Usage Instructions

Learn how to use this skill with different AI agents.

Generic Instructions

Install the toolkit with the Agent Skills CLI:

npx skills add cypress-io/ai-toolkit

Then simply ask for tests. The skill activates on requests such as "add tests for this component" or "fix this flaky spec" without you having to name Cypress.

Example Usage

"This checkout spec fails about one run in five — find the race and make it deterministic."

Description

cypress-author is part of cypress-io/ai-toolkit, the official skill set from the Cypress team. It handles the write side of testing: creating new specs, adding tests to an existing suite, updating tests after a refactor, and repairing tests that are failing or flaky — for both end-to-end and component testing.

The detail that makes it useful in practice is its trigger design. Most testing skills only activate when the user names the framework, which means an agent asked to "add tests for this file" in a Cypress project will often invent Jest or Playwright instead. This skill deliberately fires on the generic phrasings — "create tests", "write tests", "test this component", "fix this flaky spec" — and on the sight of cy.* commands, so the project's actual framework wins over whatever the model reaches for by default.

It is also scoped rather than open-ended: the skill declares Read and Edit as its allowed tools, so it changes test code and nothing else. A sibling skill, cypress-explain, covers the read-only case where someone wants a test explained or reviewed without any edits, and the toolkit additionally ships cypress-docs for documentation lookup and cypress-skill for general test generation.

Who it is for. Teams already standardised on Cypress who want agent-written tests that match their existing conventions — command usage, selector strategy, retry-ability and assertion style — instead of a generically correct spec that a reviewer then has to rewrite.

Related Skills

Skill: Redis Search

by Redis, Inc.

New

Redis' own guidance for FT.CREATE schema design, FT.SEARCH / FT.AGGREGATE / FT.HYBRID, HNSW vector similarity and RAG retrieval pipelines.

Development

Skill: Supabase

by Supabase

New

Supabase's official skill covering Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron and Queues — with a hard rule to verify against the live changelog before writing code.

Development

Skill: GSAP ScrollTrigger

by GreenSock

New

GreenSock's official ScrollTrigger skill — scroll-linked animation, pinning, scrub and trigger positioning, with the exact start/end syntax agents get wrong.

DevelopmentDesign & Creative

Skill: Cloud Solution Architect

by Microsoft

New

Microsoft's official skill that turns an agent into an Azure solution architect — 10 design principles, 6 architecture styles, 44 design patterns and a Well-Architected review workflow.

Development
Browse all skills →