Cypress Docs skill for Claude Code: answer Cypress questions from the official docs

Cypress's own skill that makes Claude answer Cypress questions from the official docs and say when it cannot verify a claim.

Installs: 8.4K; on skills.sh
Stars: 46; on GitHub
Updated: Oct 2026; last repo commit

cypress-docs makes Claude look up Cypress information in the official docs before it answers. It starts from docs.cypress.io and cypress.io, reads /llms.txt, and prefers the /llm/* markdown pages. If the docs cannot back up a claim, it must say "I could not verify this in Cypress docs" instead of inventing an API.

It bundles no scripts, and the folder holds only SKILL.md. The README says it is meant to inform and support the other Cypress skills.

Good for

Developers asking how a Cypress command, option or error works
Anyone who wants Claude to stop guessing Cypress APIs from memory
Teams using the other Cypress skills, which the skills README says this one is meant to support

Install cypress-docs

Claude Code

1
Open it in the marketplace

The Claude plugin route installs the whole Cypress toolkit: 5 skills (cypress-author, cypress-explain, cypress-docs, cypress-tap, cypress-cloud-cli) and the Cypress Cloud MCP server at https://mcp.cypress.io/mcp (from mcp/.mcp.claude.json). The README says OAuth is the default sign-in. Pick one route, not several. The skills CLI and GitHub CLI routes copy only this skill.

From the project README. Source.

What's in the skill

When it loads

Search and extract Cypress information from official documentation (docs.cypress.io, cypress.io); prefer LLM markdown under /llm/* and refuse unverified API or behavior claims.

Sections in SKILL.md

Purpose
When to use
Source Prioritization
Primary Sources (ALWAYS search first)
🤖 LLM-Optimized Docs Strategy
Critical Rules
Never Assume Missing Features
Anti-Hallucination Guard
Search Strategy
1. Classify the Query
2. Search Flow
3. Error-Aware Routing
Structured Extraction Rules
Commands
Concepts
Configuration

Key facts

Author: Cypress.io (vendor's own repo; the README says the skills are built by the Cypress team)
License: MIT (LICENSE, README and plugin.json agree)
Installs on skills.sh: 8,354 as of Nov 2, 2026
GitHub stars: 46 for the cypress-io/ai-toolkit repo, Nov 2, 2026
What is inside: 1 file: SKILL.md (git tree)
Skill version: 1.0.0 (SKILL.md frontmatter)
Part of: The cypress plugin (version 1.5.0), which holds 5 skills and the Cypress Cloud MCP server
Last commit to the repo: Oct 23, 2026
Works in: Claude, Cursor, GitHub Copilot and other tools that accept custom instructions (README)

What it includes

Searches docs.cypress.io and www.cypress.io first
These two sites are the primary sources and are always searched first.
Network · Source prioritization
Fetches /llms.txt and prefers /llm/* pages
The skill says every docs page has a markdown version under /llm, for example /llm/markdown/app/faq.md. It falls back to normal pages if /llm/* is incomplete.
Try: “Define the Cypress cy.prompt API”
Network · LLM-optimized docs strategy
Routes seven query types to docs sections
A table maps How do I, What is, API and commands, assertions, config, CI/CD and errors to different docs paths.
Read · Classify the query
Searches /llm/*, docs pages, /changelog/, then cypress.io
If your message holds an error message or stack trace, it searches /references/error-messages first, then guides and API docs.
Network · Search flow and error routing
Pulls out syntax, options, defaults and examples
Separate checklists for commands, concepts and configuration options.
Read · Structured extraction
Calls out version differences
Uses the version you give it. If you give none, it assumes the latest stable version.
Read · Version awareness
Says "I could not verify this in Cypress docs"
It must never assume Cypress lacks a feature before searching, and must offer the closest supported alternative when it can.
Read · Anti-hallucination guard
Rates answers High, Medium or Low
The rating is internal. If it is Low, Claude must tell you it is unsure.
Read · Confidence annotation

From the official docs

Permissions

Low risk

This skill makes Claude fetch public Cypress docs pages. It names no key, and the folder holds only SKILL.md.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It fetches pages from the web
SKILL.md tells Claude to fetch /llms.txt and docs pages. Allow web fetches for docs.cypress.io and cypress.io only if your tool asks. github.com
The plugin route adds 5 skills and an MCP server
The cypress plugin loads all 5 skills and the Cypress Cloud MCP server (mcp.cypress.io). The README says OAuth is the default; a personal access token needs a .mcp.json edit. Use the skills CLI route in the install box to take only this skill. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md names no read-only setting.
Talks to	docs.cypress.io. www.cypress.io
Scopes	Fetches pages from docs.cypress.io and www.cypress.io Bundles no scripts; the folder holds only SKILL.md

Questions

What does the cypress-docs skill do?

It makes Claude check the official Cypress docs before answering about commands, config, errors or behavior. If the docs cannot verify a claim, Claude should say so rather than guess.

Which sites does it use?

docs.cypress.io and www.cypress.io. It reads docs.cypress.io/llms.txt and prefers the /llm/* markdown pages.

How do I install it?

Use the install box above. The skills CLI and GitHub CLI routes copy only cypress-docs, and the plugin route installs all 5 Cypress skills. The Claude tab is an upload route we generated; the README does not describe one.

Is it official?

It is in Cypress's own repo, cypress-io/ai-toolkit. The README calls the toolkit open-source Cypress AI skills built by the Cypress team, and plugin.json lists Cypress.io as the author.

Does it need an API key or Cypress Cloud account?

SKILL.md names no key or account. It tells Claude to fetch public docs pages. Your AI tool needs permission to fetch web pages for it to work.

Is cypress-docs safe?

It bundles no scripts and the folder holds only SKILL.md. It tells Claude to fetch pages from docs.cypress.io and cypress.io, so allow web fetches only for those sites. Our advice: do not paste secrets into prompts that trigger doc lookups.

How is it different from cypress-author?

cypress-docs looks things up. Its description says to prefer cypress-author for writing or fixing tests without a documentation lookup.

Information

updated Nov 2, 2026

Repository: cypress-io/ai-toolkit
Folder: skills/cypress-docs

cypress-io/ai-toolkit skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7

cypress-io/ai-toolkit README · github.com
skills/README.md · github.com
marketplace.json · github.com
cypress-docs SKILL.md · github.com
skills.sh listing · skills.sh
plugin.json · github.com
mcp/.mcp.claude.json · github.com