Get Skills

Load and merge skills from all configured sources.

Skills are loaded from multiple sources and merged with the following precedence (later overrides earlier for duplicate names):

1. Sandbox skills (lowest) - Exposed URLs from sandbox
2. Public skills - From GitHub OpenHands/extensions repository
3. User skills - From ~/.openhands/skills/
4. Organization skills - From /.openhands or equivalent
5. Project skills (highest) - From /.openhands/skills/

Args: request: SkillsRequest containing configuration for which sources to load.

Returns: SkillsResponse containing merged skills and source counts.

POST /api/skills

Get Skills

cURL

curl --request POST \
  --url https://api.example.com/api/skills \
  --header 'Content-Type: application/json' \
  --header 'X-Session-API-Key: <api-key>' \
  --data '
{
  "load_public": true,
  "load_user": true,
  "load_project": true,
  "load_org": true,
  "marketplace_path": "marketplaces/default.json",
  "project_dir": "<string>",
  "org_config": {
    "repository": "<string>",
    "provider": "<string>",
    "org_repo_url": "<string>",
    "org_name": "<string>"
  },
  "sandbox_config": {
    "exposed_urls": [
      {
        "name": "<string>",
        "url": "<string>",
        "port": 123
      }
    ]
  }
}
'

200

{
  "skills": [
    {
      "name": "<string>",
      "type": "repo",
      "content": "<string>",
      "triggers": [
        "<string>"
      ],
      "source": "<string>",
      "description": "<string>",
      "is_agentskills_format": false
    }
  ],
  "sources": {}
}

Authorizations

X-Session-API-Key · string · header · required

Body

application/json

Request body for loading skills.

load_public · boolean · default: true

Load public skills from OpenHands/extensions repo

load_user · boolean · default: true

Load user skills from ~/.openhands/skills/

load_project · boolean · default: true

Load project skills from workspace

load_org · boolean · default: true

Load organization-level skills

marketplace_path · string | null · default: marketplaces/default.json

Relative marketplace JSON path for public skills. Set to null to load all public skills.

project_dir · string | null

Workspace directory path for project skills

org_config · OrgConfig · object

Organization skills configuration

Show child attributes

sandbox_config · SandboxConfig · object

Sandbox skills configuration

Show child attributes

Response

200

application/json

Successful Response

Response containing all available skills.

skills · SkillInfo · object[] · required

Show child attributes

sources · Sources · object

Count of skills loaded from each source

Show child attributes