{"id":"2ed0e6fd-00a5-42f8-930a-642d7346087a","shortId":"Gjdtx4","kind":"skill","title":"cypress-docs","tagline":"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.","description":"# Cypress Documentation\n\n## Purpose\nEnable the agent to retrieve accurate, up-to-date, and verifiable information about the Cypress testing framework by prioritizing official documentation and structured sources.\n\n## When to use\n\nApply this skill whenever the task depends on **finding, reading, or quoting Cypress documentation** rather than general testing intuition:\n\n- **Look up facts**: commands, APIs, assertions, lifecycle hooks, configuration options, environment variables, CLI flags, plugins, or TypeScript types as documented by Cypress.\n- **Confirm behavior**: how something works in a given Cypress version, E2E vs component testing differences, browser support, or networking/cy.intercept semantics.\n- **Before asserting “Cypress can/cannot…”**: search docs first; do not rely on memory for exact signatures, defaults, or deprecated APIs.\n- **Extract structured content**: follow the LLM-optimized docs strategy below (`llms.txt`, `/llm/*`) when fetching or summarizing doc pages.\n- **Ground answers for others**: when explaining Cypress to a user, writing examples, or reviewing code where correctness must match official docs.\n\nIf the user only needs **writing or fixing tests** without a documentation lookup, prefer `cypress-author`; if they only need **test explanation** without fetching docs, prefer `cypress-explain`. Use **this** skill when official documentation is the source of truth.\n\n## Source Prioritization\n\n### Primary Sources (ALWAYS search first)\n- https://docs.cypress.io\n- https://www.cypress.io\n\n## 🤖 LLM-Optimized Docs Strategy\n\nWhen accessing `docs.cypress.io`:\n\n1. Fetch `/llms.txt`\n\n2. Parse it to discover:\n   - LLM-friendly documentation paths\n   - Structured content endpoints\n\n3. Prefer content under `/llm/*`. Every path on the site has an optimized version hosted under `/llm` - for example, `https://docs.cypress.io/app/faq` is available at `https://docs.cypress.io/llm/markdown/app/faq.md`.\n\n4. Why:\n   - Markdown / JSON format\n   - Cleaner structure\n   - Less noise than HTML\n\n5. Fallback:\n   - If `/llm/*` is incomplete, use standard docs pages\n\n## Critical Rules\n\n### Never Assume Missing Features\n- NEVER assume Cypress does not support a feature\n- ALWAYS search before concluding\n- Retry with alternate terminology if needed\n\n### Anti-Hallucination Guard\n\nIf documentation cannot verify a claim:\n\n- Say: \"I could not verify this in Cypress docs\"\n- Provide closest supported alternative (if available)\n- DO NOT invent APIs or behavior\n\n## Search Strategy\n\n### 1. Classify the Query\n\n| Query Type        | Search Location              |\n|------------------|------------------------------|\n| How do I...      | /guides/, /core-concepts/    |\n| What is...       | /core-concepts/              |\n| API / Commands   | /api/commands/               |\n| Assertions       | /api/assertions/             |\n| Config issues    | /configuration/              |\n| CI/CD            | /guides/ci-cd/               |\n| Errors           | /references/error-messages/  |\n\n### 2. Search Flow\n\n1. `/llm/*` (via `/llms.txt`)\n2. Standard docs pages\n3. `/changelog/`\n4. `cypress.io` (blog, updates)\n\n### 3. Error-Aware Routing\n\nIf the query includes:\n- Error messages\n- Stack traces\n\nThen:\n1. Search `/references/error-messages`\n2. Expand to guides and API docs\n\n## Structured Extraction Rules\n\n### Commands\n- Syntax\n- Required arguments\n- Optional options\n- Return behavior\n- Example usage\n\n### Concepts\n- Definition\n- Key rules\n- Common pitfalls\n- Example\n\n### Configuration\n- Option name\n- Type\n- Default value\n- Example\n\n## Version Awareness\n\n- Detect Cypress version if provided\n- If NOT provided: assume latest stable version\n- If behavior differs by version:\n  - Explicitly call it out\n\n## Response Style Guidelines\n\n- Prefer official examples\n- Provide working code snippets\n- Keep answers concise but complete\n- Avoid speculation\n\n## Caching Strategy (Optional)\n\nCache frequently used topics:\n- cy.visit\n- cy.get\n- cy.intercept\n- authentication patterns\n- common configuration\n\n## Confidence Annotation\n\nInternally assess confidence:\n\n- High → Direct match in official docs\n- Medium → Inferred from multiple sources\n- Low → Unclear or edge case\n\nIf LOW:\n- Clearly communicate uncertainty\n\n## LLM Path Auto-Discovery\n\n- Always parse `/llms.txt`\n- Dynamically adapt to:\n  - New `/llm/*` paths\n  - Updated documentation formats\n\n## Safety Rules\n\n- NEVER invent Cypress APIs\n- NEVER guess syntax\n- ALWAYS verify behavior\n- Prefer \"unknown\" over incorrect\n\n## Example Behavior\n\nUser: \"How do I mock API requests in Cypress?\"\n\nAgent should:\n1. Classify → API / network\n2. Search `/llm/markdown/api/` and `/llm/markdown/guides/`\n3. Identify `cy.intercept`\n4. Extract structured details\n5. Return:\n   - Explanation\n   - Syntax\n   - Example\n   - Notes\n\n## Summary\n\nThis skill ensures:\n- Accurate answers from official sources\n- Reduced hallucination\n- Structured, high-quality outputs\n- Adaptability to evolving Cypress docs","tags":["cypress","docs","toolkit","cypress-io","agent-skills","ai-tools","skills","testing"],"capabilities":["skill","source-cypress-io","skill-cypress-docs","topic-agent-skills","topic-ai-tools","topic-cypress","topic-skills","topic-testing"],"categories":["ai-toolkit"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/cypress-io/ai-toolkit/cypress-docs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add cypress-io/ai-toolkit","source_repo":"https://github.com/cypress-io/ai-toolkit","install_from":"skills.sh"}},"qualityScore":"0.461","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 23 github stars · SKILL.md body (4,953 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:05:20.890Z","embedding":null,"createdAt":"2026-05-13T19:05:52.178Z","updatedAt":"2026-05-18T19:05:20.890Z","lastSeenAt":"2026-05-18T19:05:20.890Z","tsv":"'/api/assertions':377 '/api/commands':375 '/app/faq':272 '/changelog':397 '/configuration':380 '/core-concepts':369,372 '/guides':368 '/guides/ci-cd':382 '/llm':18,149,255,267,293,389,545 '/llm/markdown/api':585 '/llm/markdown/app/faq.md':278 '/llm/markdown/guides':587 '/llms.txt':237,391,540 '/references/error-messages':384,418 '1':235,357,388,416,579 '2':238,385,392,419,583 '3':251,396,402,588 '4':279,398,591 '5':290,595 'access':233 'accur':34,605 'adapt':542,617 'agent':31,577 'altern':320,346 'alway':222,314,538,559 'annot':508 'answer':157,487,606 'anti':325 'anti-hallucin':324 'api':22,80,136,352,373,424,555,573,581 'appli':57 'argument':432 'assert':81,119,376 'assess':510 'assum':303,307,463 'authent':503 'author':193 'auto':536 'auto-discoveri':535 'avail':274,348 'avoid':491 'awar':405,454 'behavior':24,99,354,436,468,561,567 'blog':400 'browser':113 'cach':493,496 'call':473 'can/cannot':121 'cannot':330 'case':527 'ci/cd':381 'claim':25,333 'classifi':358,580 'cleaner':284 'clear':530 'cli':88 'closest':344 'code':170,484 'command':79,374,429 'common':443,505 'communic':531 'complet':490 'compon':110 'concept':439 'concis':488 'conclud':317 'confid':507,511 'config':378 'configur':84,446,506 'confirm':98 'content':139,249,253 'correct':172 'could':336 'critic':300 'cy.get':501 'cy.intercept':502,590 'cy.visit':500 'cypress':2,7,26,44,69,97,106,120,162,192,205,308,341,456,554,576,620 'cypress-author':191 'cypress-doc':1 'cypress-explain':204 'cypress.io':13,399 'date':38 'default':133,450 'definit':440 'depend':63 'deprec':135 'detail':594 'detect':455 'differ':112,469 'direct':513 'discov':242 'discoveri':537 'doc':3,123,145,154,176,202,230,298,342,394,425,517,621 'docs.cypress.io':12,225,234,271,277 'docs.cypress.io/app/faq':270 'docs.cypress.io/llm/markdown/app/faq.md':276 'document':11,27,50,70,95,188,212,246,329,548 'dynam':541 'e2e':108 'edg':526 'enabl':29 'endpoint':250 'ensur':604 'environ':86 'error':383,404,411 'error-awar':403 'everi':256 'evolv':619 'exact':131 'exampl':167,269,437,445,452,481,566,599 'expand':420 'explain':161,206 'explan':199,597 'explicit':472 'extract':6,137,427,592 'fact':78 'fallback':291 'featur':305,313 'fetch':151,201,236 'find':65 'first':124,224 'fix':184 'flag':89 'flow':387 'follow':140 'format':283,549 'framework':46 'frequent':497 'friend':245 'general':73 'given':105 'ground':156 'guard':327 'guess':557 'guid':422 'guidelin':478 'hallucin':326,611 'high':512,614 'high-qual':613 'hook':83 'host':265 'html':289 'identifi':589 'includ':410 'incomplet':295 'incorrect':565 'infer':519 'inform':8,41 'intern':509 'intuit':75 'invent':351,553 'issu':379 'json':282 'keep':486 'key':441 'latest':464 'less':286 'lifecycl':82 'llm':15,143,228,244,533 'llm-friend':243 'llm-optim':142,227 'llms.txt':148 'locat':364 'look':76 'lookup':189 'low':523,529 'markdown':16,281 'match':174,514 'medium':518 'memori':129 'messag':412 'miss':304 'mock':572 'multipl':521 'must':173 'name':448 'need':181,197,323 'network':582 'networking/cy.intercept':116 'never':302,306,552,556 'new':544 'nois':287 'note':600 'offici':10,49,175,211,480,516,608 'optim':144,229,263 'option':85,433,434,447,495 'other':159 'output':616 'page':155,299,395 'pars':239,539 'path':247,257,534,546 'pattern':504 'pitfal':444 'plugin':90 'prefer':14,190,203,252,479,562 'primari':220 'priorit':48,219 'provid':343,459,462,482 'purpos':28 'qualiti':615 'queri':360,361,409 'quot':68 'rather':71 'read':66 'reduc':610 'refus':20 'reli':127 'request':574 'requir':431 'respons':476 'retri':318 'retriev':33 'return':435,596 'review':169 'rout':406 'rule':301,428,442,551 'safeti':550 'say':334 'search':4,122,223,315,355,363,386,417,584 'semant':117 'signatur':132 'site':260 'skill':59,209,603 'skill-cypress-docs' 'snippet':485 'someth':101 'sourc':53,215,218,221,522,609 'source-cypress-io' 'specul':492 'stabl':465 'stack':413 'standard':297,393 'strategi':146,231,356,494 'structur':52,138,248,285,426,593,612 'style':477 'summar':153 'summari':601 'support':114,311,345 'syntax':430,558,598 'task':62 'terminolog':321 'test':45,74,111,185,198 'topic':499 'topic-agent-skills' 'topic-ai-tools' 'topic-cypress' 'topic-skills' 'topic-testing' 'trace':414 'truth':217 'type':93,362,449 'typescript':92 'uncertainti':532 'unclear':524 'unknown':563 'unverifi':21 'up-to-d':35 'updat':401,547 'usag':438 'use':56,207,296,498 'user':165,179,568 'valu':451 'variabl':87 'verifi':40,331,338,560 'version':107,264,453,457,466,471 'via':390 'vs':109 'whenev':60 'without':186,200 'work':102,483 'write':166,182 'www.cypress.io':226","prices":[{"id":"a52a29b4-5cc1-426b-9d1c-c440d3efe6bf","listingId":"2ed0e6fd-00a5-42f8-930a-642d7346087a","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"cypress-io","category":"ai-toolkit","install_from":"skills.sh"},"createdAt":"2026-05-13T19:05:52.178Z"}],"sources":[{"listingId":"2ed0e6fd-00a5-42f8-930a-642d7346087a","source":"github","sourceId":"cypress-io/ai-toolkit/cypress-docs","sourceUrl":"https://github.com/cypress-io/ai-toolkit/tree/main/skills/cypress-docs","isPrimary":false,"firstSeenAt":"2026-05-13T19:05:52.178Z","lastSeenAt":"2026-05-18T19:05:20.890Z"}],"details":{"listingId":"2ed0e6fd-00a5-42f8-930a-642d7346087a","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"cypress-io","slug":"cypress-docs","github":{"repo":"cypress-io/ai-toolkit","stars":23,"topics":["agent-skills","ai","ai-tools","cypress","skills","testing"],"license":"mit","html_url":"https://github.com/cypress-io/ai-toolkit","pushed_at":"2026-05-13T21:49:12Z","description":"Fast, flexible, and open tooling for building intelligent workflows with Cypress.","skill_md_sha":"46e53346aafe33f6b1f7355f99732cbbabf9a2b4","skill_md_path":"skills/cypress-docs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/cypress-io/ai-toolkit/tree/main/skills/cypress-docs"},"layout":"multi","source":"github","category":"ai-toolkit","frontmatter":{"name":"cypress-docs","description":"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."},"skills_sh_url":"https://skills.sh/cypress-io/ai-toolkit/cypress-docs"},"updatedAt":"2026-05-18T19:05:20.890Z"}}