Keyword-Triggered Microagents - OpenHands Docs

Usage

These microagents are only loaded when a prompt includes one of the trigger words.

Frontmatter Syntax

Frontmatter is required for keyword-triggered microagents. It must be placed at the top of the file, above the guidelines. Enclose the frontmatter in triple dashes (---) and include the following fields:

Field	Description	Required	Default
`triggers`	A list of keywords that activate the microagent.	Yes	None
`agent`	The agent this microagent applies to.	No	’CodeActAgent’

Example

Keyword-triggered microagent file example located at .openhands/microagents/yummy.md:

---
triggers:
- yummyhappy
- happyyummy
---

The user has said the magic word. Respond with "That was delicious!"

See examples of microagents triggered by keywords in the official OpenHands repository