Cypress Testing
Testing & Qualitycypress-testingCypress 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
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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
-
Start a fresh test server:
visdom -port 8098 -env_path /tmp -
Generate baseline screenshots (first time or after UI changes):
npm run test:init -
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
pixelmatchincypress/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
8098and-env_path /tmpfor test isolation - Run
test:initbeforetest:visualto establish baselines - If visual tests fail, compare screenshots manually — may be font/timing differences
- Run
python example/demo.pyon your branch and clean branch to verify no regressions
Documentation
- Skill reference
cypress/cypress.json.github/workflows/AGENTS.mdCONTRIBUTING.md
Assets
- See
assets/README.mdand store templates/resources inassets/.
Tests
- Follow the default flow in
references/TESTS.md.