Skip to main content
The Momentic skills are SKILL.md files that teach a coding agent how to work with Momentic: the test file format, the MCP tools, the CLI, failure triage, and Mo. Each Momentic CLI ships the shared skills plus the skills for its own product. Install them once per repository and commit the files.
These skills are for the coding agent in your editor. Skills for Momentic’s own runtime agents (triage and result classification) live in .momentic/skills. See Runtime agent skills.

​
Install

Run the command for each CLI you use. Each command adds its own skills and keeps the skills another CLI installed.
The command asks which coding agents you use, preselects the ones it detects in the repository, and writes the skills into each agent’s directory: The pointer is a short block inside the agent’s instructions file. It lists the installed skills and tells the agent to read the matching SKILL.md before it touches Momentic tests. The block sits between <!-- MOMENTIC SKILLS START --> and <!-- MOMENTIC SKILLS END --> markers; the installer rewrites only that block, so your own instructions stay as they are.

​
Skip the prompts

Pass --target to choose agents without a prompt, or --yes to install for the agents detected in the repository:
Both flags work in CI and in agent shells.

​
Installed skills

Every CLI installs the shared skills: Each CLI adds the skill for its product: Some agents load skills on their own. Others need the skill name in the prompt:

​
Keep skills current

The skills ship inside the CLI package, so a CLI upgrade can carry new skill content. The first time you run momentic run, momentic app, momentic-mobile run, or mo start in a terminal after an upgrade with newer skills, the CLI asks once whether to update the installed files. Answer y to rewrite them for the agents you chose before. Answer n and it does not ask again for that skill version. Each CLI tracks its own skills, so an update from momentic leaves the files mo installed as they are. The prompt appears only in an interactive terminal. It does not run in CI, in non-TTY shells, or when MOMENTIC_SKIP_SKILLS_PROMPT is set. To update without the prompt, run the install command again:
Install state lives in ~/.momentic/skills.json. Delete the file to see the first-run prompt again. Each installed SKILL.md ends with a footer such as Generated for momentic 3.53.0 (skills 1788291203). Read it to see which CLI version wrote the file, and compare it with npx momentic --version in a code review to spot a stale skill.

​
Skills and the MCP server

Skills and the MCP server do different jobs. Skills are text the agent reads. The MCP server is a process the agent calls to run steps against a live browser or device. Install both: the skills tell the agent which MCP tools to call and in what order. momentic init and the onboarding wizard offer both. Pick Skills, MCP server, or both when they ask.