momentic-test — Claude Code skill: what it does, how to install
Guides coding agents in writing, running, and editing Momentic browser E2E tests in YAML format. Useful when building browser tests from natural language prompts.
npx skills add momentic-ai/skills --skill momentic-test -a claude-codeWhat momentic-test 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.
What it helps with
- 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 for the agent
- 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
How to install momentic-test
1Skills CLI (Vercel)
npx skills add momentic-ai/skills --skill momentic-test -a claude-code2Manually: put the files in place
~/.claude/skills/momentic-test/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/momentic-test/
1Skills CLI (Vercel)
npx skills add momentic-ai/skills --skill momentic-test -a codex2Manually: put the files in place
.agents/skills/momentic-test/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add momentic-ai/skills --skill momentic-test -a cursor2Manually: put the files in place
.cursor/skills/momentic-test/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install momentic-ai/skills momentic-test2Manually: put the files in place
.github/skills/momentic-test/SKILL.md1Skills CLI (Vercel)
npx skills add momentic-ai/skills --skill momentic-test -a gemini-cli2Platform CLI
gemini skills install https://github.com/momentic-ai/skills --path skills/momentic-testManually: put the files in place
.devin/skills/momentic-test/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add momentic-ai/skills --skill momentic-test -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about momentic-test
How to install momentic-test in Claude Code?
Run npx skills add momentic-ai/skills --skill momentic-test -a claude-code in your terminal.
What does the momentic-test skill do?
It guides coding assistants in writing and maintaining Momentic browser tests and modules in YAML format. It outlines workflows for MCP preview sessions, v2 file structures, and selector caching.
Why does a Momentic test fail on launch?
The test runner halts if a base URL is missing. You need to provide one through --url-override, the url property in the test file, or the BASE_URL environment variable.
