OpenParable
Skip to content
← Back to skills

Cypress Testing

Testing & Quality
cypress-testing

Cypress Testing is an Agent Skill for testing & quality published in the fossasia/visdom repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Cypress test creation, visual regression workflow, and testing best practices for Visdom

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fossasia/visdom/blob/HEAD/.agents/skills/cypress-testing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cypress-testing, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Skill: Cypress Testing

When to Use

Use this skill when writing new Cypress tests, running visual regression tests, or debugging test failures.

Core Workflow

  1. Start a fresh test server:

    visdom -port 8098 -env_path /tmp
    
  2. Generate baseline screenshots (first time or after UI changes):

    npm run test:init
    
  3. Run tests:

    npm run test           # All tests (CLI)
    npm run test:gui       # Interactive GUI
    npm run test:visual    # Visual regression only
    

Writing Tests

  • Place test files in cypress/integration/
  • Follow existing patterns from basic.js, pane.js, text.js
  • Visual regression uses pixelmatch in cypress/plugins/
  • Tests connect to server on port 8098

CI Behavior

  • Functional tests run on Python 3.8, 3.9, 3.10
  • Tests run in both WebSocket and polling modes
  • Visual regression compares PR screenshots against base branch baseline

Guardrails

  • Always use port 8098 and -env_path /tmp for test isolation
  • Run test:init before test:visual to establish baselines
  • If visual tests fail, compare screenshots manually — may be font/timing differences
  • Run python example/demo.py on your branch and clean branch to verify no regressions

Documentation

  • Skill reference
  • cypress/
  • cypress.json
  • .github/workflows/
  • AGENTS.md
  • CONTRIBUTING.md

Assets

  • See assets/README.md and store templates/resources in assets/.

Tests

  • Follow the default flow in references/TESTS.md.