Microagents Overview
Microagents are specialized prompts that enhance OpenHands with domain-specific knowledge, repository-specific context and task-specific workflows. They help by providing expert guidance, automating common tasks, and ensuring consistent practices across projects.
Microagent Types
Currently OpenHands supports the following types of microagents:
- Repository Microagents: Repository-specific context and guidelines for OpenHands.
- Public Microagents: General guidelines triggered by keywords for all OpenHands users.
When OpenHands works with a repository, it:
- Loads repository-specific instructions from
.openhands/microagents/if present in the repository. - Loads general guidelines triggered by keywords in conversations. See current Public Microagents.
Microagent Format
All microagents use markdown files with YAML frontmatter that have special instructions to help OpenHands accomplish tasks:
---
name: <Name of the microagent>
type: <MicroAgent type>
version: <MicroAgent version>
agent: <The agent type (Typically CodeActAgent)>
triggers:
- <Optional keywords triggering the microagent. If triggers are removed, it will always be included>
---
<Markdown with any special guidelines, instructions, and prompts that OpenHands should follow.
Check out the specific documentation for each microagent on best practices for more information.>