Agent skill · cypress-io
cypress-cloud-cli
Runs the cy-cloud CLI to inspect Cypress Cloud organizations, projects, runs, specs, tests, failure screenshots, and Test Replay data. Use when the user mentions Cypress Cloud, cy-cloud, cypress-cloud-cli, a Cloud run or test URL, failing or flaky Cypress tests, Test Replay, run triage, Cloud artifacts, or asks why a recorded test failed.
What it needs
About 4k tokens when loaded.
What this skill does
Cypress Cloud CLI Use cy-cloud directly to investigate Cypress Cloud. Execute the commands, inspect their JSON, and report conclusions supported by the returned data. Do not send the user to the Cloud UI when the CLI can answer the question. Start safely The published binary requires Node.js 22.21.0 or newer. Run these checks only on first use, when the environment is unknown, or after an installation or authentication error. If cy-cloud already worked in this session, invoke the investigation command directly instead of spending another turn rechecking the setup. Assume cy-cloud is already installed and available on PATH. Run it from the user's current workspace; do not locate, clone, build, or depend on the cloud-cli source repository. If the command is unavailable, stop and report the missing prerequisite. The user can install it with: If unauthenticated, ask the user to choose an authentication method: For CI or an existing environment, CYPRESSCLOUDTOKEN takes precedence over stored credentials and writes no credential file. Never print, echo, read back, or commit tokens. Never inspect ~/.config/cy-cloud/auth.json or cypress.env.json; use cy-cloud status. The organization must have the Cypress Cloud CLI integration enabled. A response saying it is not enabled requires action from an organization administrator; it cannot be fixed with another CLI command. Discover instead of guessing Every command supports: Treat cy-cloud --help as authoritative for available commands, per-command --help as authoritative for arguments, and --schema as the intended response contract. Use them before constructing a query when a command, flag, or field is uncertain. Do not memorize a command inventory from this skill; the installed CLI may be newer or older than these instructions. Validate the actual response too: run get can return a fractional duration, and replay info.failedAt can be a fractional epoch even when the schema declares an integer. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills cypress-io/cypress-cloud-cli