Install a skill - CREAO Documentation

curl --request POST \
  --url https://developer.creao.ai/v1/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "github"
}
'

{
  "skill_id": "<string>",
  "kind": "builtin",
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "enabled": true,
  "core": true,
  "source_url": "<string>",
  "tags": [
    "<string>"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "content": "<string>",
  "files": {}
}

POST

/

v1

/

skills

curl --request POST \
  --url https://developer.creao.ai/v1/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "github"
}
'

{
  "skill_id": "<string>",
  "kind": "builtin",
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "enabled": true,
  "core": true,
  "source_url": "<string>",
  "tags": [
    "<string>"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "content": "<string>",
  "files": {}
}

Authorizations

Authorization

string

header

default:cr_sk_your_key_here

required

Account API key from Developer Console. Keys start with cr_sk_.

Body

application/json

source

enum<string>

required

Available options:

github,

content

source_url

string

Required when source is github.

Maximum string length: 1024

content

string

SKILL.md text. Required when source is content.

Maximum string length: 262144

files

object

Supporting files. Combined size must be 5 MB or smaller.

Show child attributes

name

string

Maximum string length: 64

description

string

Maximum string length: 2000

tags

string[]

Maximum array length: 10

Maximum string length: 50

enabled

boolean

default:true

Response

Existing custom skill updated.

skill_id

string

required

Public skill id. Custom skills use custom-{name}.

kind

enum<string>

required

Available options:

builtin,

custom

name

string

required

display_name

string

required

description

string | null

required

enabled

boolean

required

core

boolean

required

source_url

string | null

required

tags

string[]

required

created_at

string<date-time> | null

required

updated_at

string<date-time> | null

required

id

string<uuid> | null

Custom-skill row UUID. Null for built-ins. Read-only metadata; not used in paths.

content

string

SKILL.md body. Present on GET and install, omitted from list.

files

object | null

Supporting files for custom skills. Present on GET and install.

Show child attributes