Prompt templates

Create your first templateCopy Anchor Link

A prompt template saves instructions you use repeatedly and exposes them as a slash command. Use one for a consistent review checklist, a release summary, a test plan, or any other task that does not need custom program logic.

Create .omp/prompts/review-change.md in the project where you want to use the command:

---
description: Review one area of this project for correctness
---

Review the code related to $1.

Focus on: $@[2:].

Report concrete findings first, with file and line references. Then list any
remaining risks or missing tests. Do not change files.

Start a new omp session in that project, then type:

/review-change authentication "error handling and tests"

The filename creates the /review-change command. omp expands $1 to authentication, expands $@[2:] to error handling and tests, and sends the resulting Markdown as your message. The description appears beside the command in / autocomplete.

Use .omp/prompts/ for prompts shared with a project. For a command available in every project, save the same Markdown file under ~/.omp/agent/prompts/ instead.

Pass argumentsCopy Anchor Link

Arguments follow the command name. Spaces and tabs separate arguments; matching single or double quotes keep text together and the quote characters are removed.

/review-change payments "retry behavior" tests

Indexes are one-based. A missing positional argument, an out-of-range slice, or a non-positive slice index expands to an empty string.

The argument parser does not have a backslash escape syntax. If an argument contains spaces, wrap it in the other quote style rather than trying to escape the surrounding quote. Empty quoted arguments are discarded.

If the template has no argument placeholder, omp does not throw the supplied text away. It appends the joined arguments to the prompt after a blank line:

Summarize the requested part of this project.

Invoking /summarize src/auth sends the template followed by src/auth.

Use Handlebars interpolationCopy Anchor Link

After replacing the $… placeholders, omp renders the result as a Handlebars template. The most useful values are:

For example:

---
description: Draft a test plan for a feature
---

Draft a test plan for {{default (arg 1) "the current change"}}.
{{#if args}}
Additional context: {{arguments}}
{{/if}}

Shell-style substitution happens first and Handlebars rendering happens second. Argument values containing $1, $@, or $ARGUMENTS are not recursively substituted. A template that uses either style of inline argument placeholder does not also receive the automatic argument suffix.

For ordinary reusable prompts, prefer the $1 and $@ forms: they are shorter and make the invocation easy to understand. Use Handlebars only when you need defaults or conditional sections.

Add a descriptionCopy Anchor Link

Only description has special meaning in an omp prompt template's YAML frontmatter:

---
description: Explain a failing test and propose the smallest fix
---

Put frontmatter at the beginning of the file. If description is absent, omp uses the first non-empty body line, truncated to 60 characters, in autocomplete. The command name always comes from the Markdown filename; a frontmatter name field does not rename it.

Discovery and namingCopy Anchor Link

At session startup, omp recursively discovers Markdown files in these locations:

Only the final filename becomes the command name. Both .omp/prompts/frontend/review.md and .omp/prompts/backend/review.md define /review, not namespaced commands. Give every template a unique filename even when you organize files into subdirectories.

Prompt templates are Markdown prompts, not executable command modules. If a command needs to run custom program logic or display its own UI, build an extension instead.

PrecedenceCopy Anchor Link

omp loads user templates before project templates and uses the first matching name. As a result, ~/.omp/agent/prompts/review.md wins over .omp/prompts/review.md. This differs from many project-overrides-user configuration systems, so unique names are the safest choice.

Other slash-command types resolve before prompt templates. A built-in, extension command, custom command, skill command, or file-based slash command with the same name wins; the conflicting prompt template is omitted from autocomplete.

Reload after editingCopy Anchor Link

Prompt templates are read when the session starts. omp does not watch these files, and /reload-plugins does not reload them. After creating, renaming, or editing a template, exit and start a new omp session in the intended working directory.

TroubleshootingCopy Anchor Link