Skip to main content
POST
Install Skill Endpoint

Authorizations

X-Session-API-Key
string
header
required

Body

application/json

Request body for installing a skill.

source
string
required

Skill source - git URL, GitHub shorthand, or local path. Examples: 'https://github.com/OpenHands/extensions/tree/main/skills/github', 'github:OpenHands/extensions/skills/github', '/path/to/skill'

Minimum string length: 1
force
boolean
default:false

If true, overwrite existing installation

ref
string | null

Optional branch, tag, or commit to install

repo_path
string | null

Subdirectory path within the repository (for monorepos)

Response

Successful Response

Response containing installed skill information.

install_path
string
required

Path where the skill is installed

installed_at
string
required

ISO 8601 timestamp of installation

name
string
required

Skill name

source
string
required

Original source (e.g., 'github:owner/repo')

description
string
default:""

Skill description

enabled
boolean
default:true

Whether the skill is enabled

repo_path
string | null

Subdirectory path within the repository

resolved_ref
string | null

Resolved git commit SHA

version
string
default:""

Skill version