Skip to main content

Global Microagents

Overview​

Global microagents are keyword-triggered microagents that apply to all OpenHands users. A list of the current global microagents can be found in the OpenHands repository.

Contributing a Global Microagent​

You can create global microagents and share with the community by opening a pull request to the official repository.

See the CONTRIBUTING.md for specific instructions on how to contribute to OpenHands.

Global Microagents Best Practices​

  • Clear Scope: Keep the microagent focused on a specific domain or task.
  • Explicit Instructions: Provide clear, unambiguous guidelines.
  • Useful Examples: Include practical examples of common use cases.
  • Safety First: Include necessary warnings and constraints.
  • Integration Awareness: Consider how the microagent interacts with other components.

Steps to Contribute a Global Microagent​

1. Plan the Global Microagent​

Before creating a global microagent, consider:

  • What specific problem or use case will it address?
  • What unique capabilities or knowledge should it have?
  • What trigger words make sense for activating it?
  • What constraints or guidelines should it follow?

2. Create File​

Create a new Markdown file with a descriptive name in the appropriate directory: microagents/

3. Testing the Global Microagent​

  • Test the agent with various prompts.
  • Verify trigger words activate the agent correctly.
  • Ensure instructions are clear and comprehensive.
  • Check for potential conflicts and overlaps with existing agents.

4. Submission Process​

Submit a pull request with:

  • The new microagent file.
  • Updated documentation if needed.
  • Description of the agent's purpose and capabilities.