Skip to main content
POST
Create a skill

Authorizations

x-cominty-token
string
header
required

A Cominty Platform API secret. A key created now starts with sk-cmt-. Send it as is, or as Bearer sk-cmt-..., with at most one Bearer prefix. A key created before the prefix existed has no sk-cmt- and still works.

Body

multipart/form-data
display_name
string
required

Name shown in lists. 1 to 100 characters.

Maximum string length: 100
file
file
required

Zip archive of at most 30 MB. SKILL.md at the root, or inside one top-level folder.

scope
enum<string> | null
default:private

private (the key's user only) or organization. Defaults to private.

Available options:
organization,
private

Response

Successful Response

id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required

When the default version was uploaded.

display_name
string
required
active
boolean
required
scope
enum<string> | null
required

null for a built-in skill.

Available options:
organization,
private
frontmatter
SkillFrontmatter · object
required
source
enum<string>
required
read-only

cominty for a built-in, read-only skill. custom for one you uploaded.

Available options:
cominty,
custom