From 0c1c570dac654ba6536d1eaaa30a65dcb0416971 Mon Sep 17 00:00:00 2001 From: Engel Nyst Date: Tue, 24 Jun 2025 17:04:36 +0200 Subject: [PATCH] Microagents doc (for LLMs) (#9324) Co-authored-by: OpenHands-Claude Co-authored-by: Xingyao Wang --- .openhands/microagents/glossary.md | 2 +- .openhands/microagents/repo.md | 23 +++++++++++++++++++++++ 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/.openhands/microagents/glossary.md b/.openhands/microagents/glossary.md index 718ce01ab3..66b5655086 100644 --- a/.openhands/microagents/glossary.md +++ b/.openhands/microagents/glossary.md @@ -121,7 +121,7 @@ A specialized prompt that enhances OpenHands with domain-specific knowledge, rep A central repository of available microagents and their configurations. #### Public Microagent -A general-purpose microagent available to all OpenHands users, triggered by specific keywords. +A general-purpose microagent available to all OpenHands users, triggered by specific keywords. Located in `microagents/`. #### Repository Microagent A type of microagent that provides repository-specific context and guidelines, stored in the `.openhands/microagents/` directory. diff --git a/.openhands/microagents/repo.md b/.openhands/microagents/repo.md index 08dc994bdf..91ef466e72 100644 --- a/.openhands/microagents/repo.md +++ b/.openhands/microagents/repo.md @@ -68,6 +68,29 @@ If you are starting a pull request (PR), please follow the template in `.github/ These details may or may not be useful for your current task. +### Microagents + +Microagents are specialized prompts that enhance OpenHands with domain-specific knowledge and task-specific workflows. They are Markdown files that can include frontmatter for configuration. + +#### Types: +- **Public Microagents**: Located in `microagents/`, available to all users +- **Repository Microagents**: Located in `.openhands/microagents/`, specific to this repository + +#### Loading Behavior: +- **Without frontmatter**: Always loaded into LLM context +- **With triggers in frontmatter**: Only loaded when user's message matches the specified trigger keywords + +#### Structure: +```yaml +--- +triggers: +- keyword1 +- keyword2 +--- +# Microagent Content +Your specialized knowledge and instructions here... +``` + ### Frontend #### Action Handling: