Skip to main content

Global Skill Registry

The official global skill registry is hosted at github.com/OpenHands/skills. This repository contains community-shared skills that can be used by all OpenHands users.

Contributing a Global Skill

You can create global skills and share with the community by opening a pull request to the official skill registry. See the OpenHands Skill Registry for specific instructions on how to contribute a global skill.

Global Skills Best Practices

  • Clear Scope: Keep the skill 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 skill interacts with other components.

Steps to Contribute a Global Skill

1. Plan the Global Skill

Before creating a global skill, 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 official skill registry: github.com/OpenHands/skills

3. Testing the Global Skill

  • 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 skill file.
  • Updated documentation if needed.
  • Description of the agent’s purpose and capabilities.