Skip to main content
POST
Create a skill
Creates a new skill in your catalog. Returns 201. Returns the created Skill object.

Request body

The body is the Skill object. See that page for the full meaning of each field; the constraints that matter when creating one are below.
name
string
required
Catalog identifier, kebab-case with an optional single org/ namespace prefix. The h/ prefix is reserved for H’s catalog (rejected with 403) and marks the skill as reserved; any other name creates a custom skill, private to your organization. Immutable after creation.
description
string
required
One-line routing hint used for discovery. Non-empty.
body
string
required
The Markdown prompt fragment the agent receives at runtime. Non-empty.
source
string
Optional provenance URL.
url_pattern
string
Optional, informational regex hinting at URLs where this skill applies. 1 to 1024 characters.

Examples

Response

Errors