Prompts

Prompt templates are reusable Handlebars fragments you author once and share across agents. A template might be a common header, a house style for tool output, or a block of domain context. They keep the same wording in every agent instead of being pasted into each agent.md.

Templates are .hbs files under a templates/ directory and are managed with the distri prompts commands.

Write a template

{{! templates/support-style.hbs }}
You are a support agent for {{company}}.

- Answer in two sentences or fewer.
- Never invent order numbers or refund amounts.
- If you are unsure, hand off with `transfer_to_agent`.

Handlebars variables ({{company}}) are filled at runtime from the agent's context and any dynamic_sections you pass from the client. See Agent Definition → Handlebars Templates for the variables available inside a prompt.

Push and list

distri prompts push templates/support-style.hbs   # one template
distri prompts list                               # what's in the workspace

distri push (with no arguments) syncs the whole agents/, skills/, and templates/ tree at once, so a single distri push deploys your prompts alongside everything else.

Reference a template from an agent

Agents pull templates in through partials, so a shared fragment renders inside the agent's instructions:

[partials]
custom_header = "prompts/support-style.hbs"

{{> custom_header}}

# ROLE
Handle billing questions for existing customers.

Next

• Agent Definition: the full agent.md format, partials, and Handlebars variables.
• CLI Reference: every distri prompts command.