OpenHands Extensions

This repository is the public extensions registry for OpenHands. It contains reusable, shareable skills and plugins that customize agent behavior.

Skills overview docs: https://docs.openhands.dev/overview/skills
SDK skill guide: https://docs.openhands.dev/sdk/guides/skill

Repository Layout

Skills

Skills are Markdown-based guidelines that provide domain-specific knowledge and instructions. They live under skills/, one directory per skill:

skills/<skill-name>/SKILL.md — the skill definition (AgentSkills-style progressive disclosure)
skills/<skill-name>/README.md — optional human-facing notes/examples

Browse the catalog in skills/.

Plugins

Plugins are extensions with executable code components (hooks, scripts). They live under plugins/, one directory per plugin:

plugins/<plugin-name>/SKILL.md — the plugin definition
plugins/<plugin-name>/hooks/ — lifecycle hooks
plugins/<plugin-name>/scripts/ — utility scripts

Browse available plugins in plugins/.

NPM Package

This repository also publishes catalog data through the @openhands/extensions package. It requires Node.js 18.20.0 or newer because the catalog entry points import JSON modules with import attributes.

import { AUTOMATION_CATALOG, INTEGRATION_CATALOG } from "@openhands/extensions";
import { INTEGRATION_CATALOG as MCP_MARKETPLACE } from "@openhands/extensions/integrations";
import { AUTOMATION_CATALOG as RECOMMENDED_AUTOMATIONS } from "@openhands/extensions/automations";

React logo components are isolated behind a separate export so data-only consumers do not need React peer dependencies:

import { INTEGRATION_LOGOS } from "@openhands/extensions/integrations/logos";

The package ships the whole repo, so the skills/, plugins/, and marketplaces/ trees are available from the installed package. Resolve content files to a path, or import JSON manifests directly:

// .md / .py / etc.: resolve to a path, then read with fs
const skillPath = import.meta.resolve("@openhands/extensions/skills/code-review/SKILL.md");

// .json: import directly
import marketplace from "@openhands/extensions/marketplaces/openhands-extensions.json" with { type: "json" };

See integrations/README.md, automations/README.md, and MIGRATION.md for catalog-specific details.

Extensions Catalog

This repository contains 2 marketplace(s) with 57 extensions (47 skills, 10 plugins).

large-codebase

OpenHands skills for interacting, improving, and refactoring large codebases

4 extensions (2 skills, 2 plugins)

Name	Type	Description	Commands
add-javadoc	skill	Add comprehensive JavaDoc documentation to Java classes and methods. Use when documenting Java code, adding API docum...	—
cobol-modernization	plugin	End-to-end COBOL to Java migration workflow. Handles build setup, mainframe dependency removal, and code migration wi...	—
migration-scoring	plugin	Evaluate code migration quality with coverage, correctness, and style scoring. Generates executive reports with actio...	—
spark-version-upgrade	skill	Upgrade Apache Spark applications between major versions (2.x→3.x, 3.x→4.x). Covers build files, deprecated APIs, con...	—