# momentic-test

Guides coding agents in writing, running, and editing Momentic browser E2E tests in YAML format. Useful when building browser tests from natural language prompts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 68500 installs · ★ 16
- Author: momentic-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/momentic-ai/skills/tree/HEAD/skills/momentic-test/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/momentic-test

## What it does

This skill directs coding agents on managing browser test suites built with Momentic. The framework converts plain-text instructions into browser events using a custom Playwright fork and CDP. The agent writes tests and modules inside `*.test.yaml` and `*.module.yaml` files under the v2 schema. Legacy v1 files require `momentic_test_splice_steps` instead of direct edits.

Interactive testing relies on MCP sessions. Tools return step handles and screenshots for safe polling without timeouts. Runs fail without a valid base URL. You must supply it through CLI options, file fields, or environment variables.

Every referenced script or module must use relative paths like `./...` or `../...`. Cached selector metadata speeds up repeats by preventing redundant model queries.

## Requirements
- Works with: Playwright

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add momentic-ai/skills --skill momentic-test -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/momentic-test/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/momentic-test/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add momentic-ai/skills --skill momentic-test -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/momentic-test/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add momentic-ai/skills --skill momentic-test -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/momentic-test/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install momentic-ai/skills momentic-test
```

2. **Manually: put the files in place**
- File: `.github/skills/momentic-test/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add momentic-ai/skills --skill momentic-test -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/momentic-ai/skills --path skills/momentic-test
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/momentic-test/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add momentic-ai/skills --skill momentic-test -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/momentic-ai/skills/tree/HEAD/skills/momentic-test/SKILL.md

## When to use it
- author browser E2E test flows in YAML
- build reusable test modules for web applications
- inspect and preview test checkpoints using MCP sessions
- update legacy test files via `momentic_test_splice_steps`

## Example prompts
- Create a new checkout E2E test using momentic-test in checkout.test.yaml
- Start an MCP preview session to validate login steps in login.test.yaml
- Update navigation steps in auth.module.yaml using relative paths

## Similar
- [playwright-skill](https://affpapa.org/en/nevibecode/skills/playwright-skill.md) — skill · 6900 installs
- [om-integration-tests](https://affpapa.org/en/nevibecode/skills/om-integration-tests.md) — skill · 3000 installs
- [agentic-browser-testing](https://affpapa.org/en/nevibecode/skills/agentic-browser-testing.md) — skill · 1400 installs
- [playwright](https://affpapa.org/en/nevibecode/skills/secondsky-playwright.md) — skill · 1000 installs
- [e2e-testing-automation](https://affpapa.org/en/nevibecode/skills/e2e-testing-automation.md) — skill · 689 installs
- [recording-browser-flow-as-test](https://affpapa.org/en/nevibecode/skills/recording-browser-flow-as-test.md) — skill · 406 installs

From the same set: [momentic-ai/skills](https://affpapa.org/en/nevibecode/by/momentic-ai/skills.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md