Skip to content

Conversation

@xingyaoww
Copy link
Contributor

This PR migrates all public skills from the main OpenHands repository to this dedicated skills repository.

Changes

  • Added 26 skill files covering various domains (git, docker, kubernetes, code review, etc.)
  • Includes comprehensive README explaining the skills system

Motivation

Moving skills to a separate repository enables:

  • Independent versioning and releases
  • Ability to load skills dynamically from a public registry
  • Easier community contributions
  • Separation of concerns between core OpenHands code and skill library

Related Work

  • Related SDK PR will add load_public_skills() function to automatically load skills from this repository

This is part of the effort discussed in OpenHands/software-agent-sdk#1219 to centralize and externalize the skills/microagents library.

@xingyaoww can click here to continue refining the PR

This commit migrates all skills from the OpenHands/skills directory to this
separate skills repository. These skills can now be loaded independently and
versioned separately from the main OpenHands codebase.

Co-authored-by: openhands <openhands@all-hands.dev>
Move all skill .md files into a skills/ subdirectory to keep the repository
root clean and organized.

Co-authored-by: openhands <openhands@all-hands.dev>
@xingyaoww xingyaoww marked this pull request as ready for review November 25, 2025 15:33
Add detailed README.md that explains:
- What Skills are (formerly Microagents)
- Two types: General and Keyword-Triggered
- How to use Skills in OpenHands
- How to create custom Skills for projects
- Contributing guidelines with templates
- Frontmatter reference documentation
- Examples from the skills/ directory

Based on OpenHands documentation at:
https://docs.openhands.dev/openhands/usage/microagents

Co-authored-by: openhands <openhands@all-hands.dev>
General skills do not use frontmatter. Updated:
- Changed 'Frontmatter: Optional' to 'Frontmatter: Not used'
- Removed frontmatter from general skill example
- Removed frontmatter from general skill template
- Clarified in frontmatter reference that general skills don't use it

Co-authored-by: openhands <openhands@all-hands.dev>
Reduced README from 200+ lines to 88 lines:
- Simplified overview and skill types sections
- Removed verbose templates and detailed guidelines
- Reduced contributing section to essentials
- Streamlined frontmatter reference
- Condensed examples section
- Briefly mentioned microagents name and backward compatibility

Co-authored-by: openhands <openhands@all-hands.dev>
@xingyaoww xingyaoww merged commit f96260e into main Nov 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants