Skip to main content
Agent skills let you commit project-specific guidance for Momentic’s runtime agents to your repository. Use them to describe how to start and reach the app under test, authentication and environment details, and any conventions the agents should follow.
Agent skills are in beta and may change.
These skills guide Momentic’s own agents during runs. Skills for the coding agent in your editor (Claude Code, Cursor, Codex) install with npx momentic skills. See Coding agent skills.

​
Layout

Each skill is a directory under .momentic/skills containing a SKILL.md file. You can use intermediate directories to group related skills:
The directory containing SKILL.md defines the skill name, while the path from .momentic/skills identifies the skill.

​
Where skills are discovered

Skills conventionally live at the repository root. Momentic looks for a .momentic/skills folder starting at the project root (the directory containing momentic.config.yaml) and walking up through its ancestors, and uses the first one it finds. When your project root is a subdirectory of the repository, as in a monorepo, keep a single .momentic/skills at the repository root so every project in the repository shares it; a .momentic/skills folder nearer to a project root takes over entirely for that project. SKILL.md is Markdown with a YAML frontmatter block:

​
Frontmatter

The supported agent targets are result-classification and triage.

​
How skills are applied

  • A skill applies to an agent when its agents list includes that agent, or when agents is omitted. Every applicable skill is always used.
  • Matching skills are combined in skill-name order, then path order when names match. Each skill’s name, path, and description are added to the agent’s instructions.
  • Target a single agent (e.g. agents: [triage]) to prompt that agent specifically. Target several agents to reuse the same guidance across them.
  • Momentic skips a skill with missing frontmatter, invalid YAML, an unknown agent target, an empty body, or a name that doesn’t match its directory, and prints a warning naming the file so you can fix it.

​
Skills and prompt flags

Some agents also accept prompt flags for one-off or path-specific guidance. momentic ai select, for example, takes --prompt. Skills apply automatically and stack with any prompt flags, so you can commit shared guidance as skills and still pass one-off instructions per run.