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.

Python Package

The integration catalog is also published as a Python package (openhands-extensions) so Python services read the same catalog data as JS consumers. The single source of truth is the hand-authored JSON asset integrations/integration-catalog.json (NOT generated from any .mjs/.js source). Each per-integration entry also exists as integrations/catalog/<id>.json; a CI parity test asserts the two never drift. Both the JS package (@openhands/extensions/integrations) and the Python package read that same JSON asset at runtime, so the two language bindings can never drift.

The catalog is one array where each entry can carry oauth and/or mcp/http connectionOptions. supportsOauth / supportsMcp flags are derived at runtime. Use listIntegrationCatalog({ mcp, oauth }) (JS) or list_integration_catalog(mcp=, oauth=) (Python) to filter by connector type - for example only integrations that support an oauth connector.

from openhands_extensions import (
    list_integration_catalog,                        # listIntegrationCatalog({ mcp, oauth })
    get_integration_catalog_entry,                   # getIntegrationCatalogEntry(id)
    INTEGRATION_CATALOG_SNAPSHOT,                    # { integrations }
)

all_integrations = list_integration_catalog()
oauth_integrations = list_integration_catalog(oauth=True)      # only entries with an oauth connector
mcp_integrations = list_integration_catalog(mcp=True)          # only entries with an mcp connector
hubspot = get_integration_catalog_entry("hubspot")

Install from git (the hub backend consumes it this way):

pip install git+https://github.com/OpenHands/extensions.git

The JS and Python versions are kept in lock-step by release-please and guarded by tests/test_version_alignment.py.

Extensions Catalog

This repository contains 2 marketplace(s) with 58 extensions (48 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...	—