⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.5.0

cypress-author

cypress-io@cypress-io⭐ 48 stars· last commit 9d ago· 3 open issues

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.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐ 48 on GitHubGitHub ↗

Growing

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

✨ 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(), Studio AI, Cloud MCP, Test Intent and Error Summaries, and UI Coverage test generation. Learn more in the Cypress AI documentation.

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.

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

ToolWhen to use
Cypress Claude ConnectorFor Claude Desktop app users
Cypress Cursor PluginFor Cursor users
Cypress VS Code Extension (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 — Improves how AI tools create, update, and fix Cypress tests. Use it when you're writing new tests or fixing broken ones.
  • 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 - Helps your agent research and retrieve information about Cypress more efficiently and reliably.
  • 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 — 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 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 or open a PR.

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 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 package:

    npx skills add cypress-io/ai-toolkit
    
  • GitHub CLI:

    gh skill install cypress-io/ai-toolkit
    
  1. 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 or the Cypress AI Skills docs.

  2. Connect Cypress Cloud MCP with the installer for your agent (see the MCP table above). You can also copy the configuration from mcp/ or follow the configuration instructions here.

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 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

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • skills/cypress-author/SKILL.md2.5 KBupstream ↗
    ---
    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.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/cypress-io-ai-toolkit-skills-cypress-author.md

// REPO STATS

48 stars
3 open issues
Last commit: 9d ago