Agent skill · cypress-io
cypress-tap
Drives a running Cypress open-mode session through `cypress tap` to run and rerun specs, wait for fresh results, inspect reporter and command logs, and query or rewind the app under test through DOM, accessibility, styles, and snapshots. Use when authoring or debugging Cypress e2e or component specs, discovering selectors, diagnosing failures, or verifying test behavior without GUI interaction. Not for one-shot headless runs. Requires Cypress 15.21+, a Chromium-family browser, and a running `cypress open` session.
What it needs
About 5k tokens when loaded.
What this skill does
Driving Cypress with cypress tap cypress tap controls an already-running cypress open session. Use it to iterate on specs, inspect the reporter and command log, and read the app under test without GUI interaction. Use cypress run instead for a one-shot headless batch. Prerequisites Confirm from package metadata or the lockfile that the resolved Cypress is 15.21.0+ and contains tap. Do not use tap --help to probe an unknown older build; prereleases below the version floor may attempt session discovery instead of printing help. The session must use Electron, Chrome, Chromium, or Edge. Firefox and WebKit are unsupported. cypress open and any configured baseUrl dev server must already be running. The cwd chooses both the Cypress binary and the automatically selected session. When the target project pins an older Cypress, run tap from a compatible checkout and pass --session <pid> on every call. Route by task Start, select, or poll a session: read session-lifecycle.md. Run a spec or read its results: read session-lifecycle.md and reading-results.md. Author or inspect a spec: read recipes.md and reading-the-app.md. Diagnose a failure: read recipes.md, reading-results.md, and reading-the-app.md. Command failure, hang, wrong project, or surprising output: read troubleshooting.md. One noninteractive batch: use cypress run, not tap. Read only the references required for the current task. Core commands sessions: reachable sessions, project roots, testing types, and browsers; JSON adds support and renderer health. status: lifecycle stage, selected spec, run identity, counts, build error, and active pin. specs: runnable project-relative spec paths for the session's testing type. run <spec>: dispatches a spec and returns immediately. reporter: spec overview and test ids; with --test-id, the complete test attempt. command: one command-log row with network data, snapshots, and console properties. pin: rewinds the app frame to a command snapshot. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills cypress-io/cypress-tap