Skip to main content
POST
Upload a skill

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Body

application/json

Inline markdown: server wraps it as SKILL.md in a single-file tarball. Covers the "paste a paragraph or two" case.

body_markdown
string
required
kind
enum<string>
required
Available options:
markdown
name
string
required

Display name (3–60 chars, alphanumeric + spaces/hyphens). Used to derive the slug.

description
string | null

One-line description shown on the Skills page.

profile
string | null

Runtime profile this pack targets. Defaults to claude-sdk.

provides
string | null

Capability slot this skill fills, e.g. app-design. When set (and the skill is enabled), it supersedes the platform default that provides the same capability for this workspace - the tenant's own instructions replace ours. Brand tokens still flow via the workspace preamble, independent of which design skill is active.

Response

Workspace skill created

slug
string
required
version
string
required