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.

Layout

Each skill is a directory under .momentic/skills containing a SKILL.md file:
SKILL.md is Markdown with a YAML frontmatter block:

Frontmatter

The supported agent targets are explore, 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 and added to the agent’s instructions, along with each skill’s name and description.
  • Target a single agent (e.g. agents: [triage]) to prompt that agent specifically. Target several agents to reuse the same guidance across them.
  • A skill that can’t be read — missing frontmatter, invalid YAML, an unknown agent target, an empty body, or a name that doesn’t match its directory — is skipped, and Momentic 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. The explore agent, for example, takes --prompt and --prompt-file. 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.