Cortex API

Skills

Endpoint

Agent Skills (agentskills.io) installation and configuration

List installed skills

GET

http://localhost:8000

/api/admin/skills

List all installed agent skills. Admin-only.

List installed skills › Responses

200

Installed skills retrieved

object[]

Skill summary (id, name, description, enabled, source, etc.)

Search the skills registry

GET

http://localhost:8000

/api/admin/skills/registry/search

Search the skills.sh registry for skills. Admin-only.

Search the skills registry › query Parameters

q

string · required

Search query

Search the skills registry › Responses

200

Registry search results

object[]

Registry item (namespace, name, description, install_count, download_url)

GET/api/admin/skills/registry/search

curl --request GET \
  --url 'http://localhost:8000/api/admin/skills/registry/search?q=%3Cstring%3E'

shell

Example Responses

[
  {}
]

json

application/json

Install a skill

POST

http://localhost:8000

/api/admin/skills/install

Install a skill from a direct URL or a skills.sh registry identifier. Provide exactly one of url or registry_id. Admin-only.

Install a skill › Request Body

Provide exactly one of url or registry_id.

url

string

Direct URL to SKILL.md or ZIP archive

registry_id

string

Registry identifier (namespace/name) from skills.sh

Install a skill › Responses

Skill installed

Installed skill details

POST/api/admin/skills/install

curl --request POST \
  --url http://localhost:8000/api/admin/skills/install \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "url",
  "registry_id": "registry_id"
}
'

shell

Example Request Body

{
  "url": "url",
  "registry_id": "registry_id"
}

json

Example Responses

{}

json

application/json

Discover local skills

POST

http://localhost:8000

/api/admin/skills/discover

Re-scan the local skills directory for newly added skills. Admin-only.

Discover local skills › Responses

200

Discovery completed

message

string

count

integer

POST/api/admin/skills/discover

curl --request POST \
  --url http://localhost:8000/api/admin/skills/discover

shell

Example Responses

{
  "message": "message",
  "count": 0
}

json

application/json

Get skill detail

GET

http://localhost:8000

/api/admin/skills/{skill_id}

Get full skill details including the SKILL.md body and tools config. Admin-only.

Get skill detail › path Parameters

skill_id

string · required

Get skill detail › Responses

Skill detail retrieved

Full skill detail

GET/api/admin/skills/{skill_id}

curl --request GET \
  --url http://localhost:8000/api/admin/skills/:skill_id

shell

Example Responses

{}

json

application/json

Uninstall a skill

DELETE

http://localhost:8000

/api/admin/skills/{skill_id}

Uninstall a skill and delete its files. Admin-only.

Uninstall a skill › path Parameters

skill_id

string · required

Uninstall a skill › Responses

Skill deleted

message

string

DELETE/api/admin/skills/{skill_id}

curl --request DELETE \
  --url http://localhost:8000/api/admin/skills/:skill_id

shell

Example Responses

{
  "message": "message"
}

json

application/json

Update skill settings

PATCH

http://localhost:8000

/api/admin/skills/{skill_id}

Update a skill's settings (enable/disable). Admin-only.

Update skill settings › path Parameters

skill_id

string · required

Update skill settings › Request Body

enabled

boolean | null

Enable or disable the skill

Update skill settings › Responses

Skill updated

Updated skill

PATCH/api/admin/skills/{skill_id}

curl --request PATCH \
  --url http://localhost:8000/api/admin/skills/:skill_id \
  --header 'Content-Type: application/json' \
  --data '{
  "enabled": {}
}'

shell

Example Request Body

{
  "enabled": {}
}

json

Example Responses

{}

json

application/json

Analyze skill configuration

POST

http://localhost:8000

/api/admin/skills/{skill_id}/analyze

Analyze a skill's SKILL.md with the primary LLM to extract configuration variables and API base URL. Admin-only.

Analyze skill configuration › path Parameters

skill_id

string · required

Analyze skill configuration › Responses

Analysis result

skill_id

string

object[]

base_url

string | null

POST/api/admin/skills/{skill_id}/analyze

curl --request POST \
  --url http://localhost:8000/api/admin/skills/:skill_id/analyze

shell

Example Responses

{
  "skill_id": "skill_id",
  "variables": [
    {}
  ],
  "base_url": {}
}

json

application/json

Get skill configuration

GET

http://localhost:8000

/api/admin/skills/{skill_id}/config

Get a skill's configuration schema, base URL, and current values (secret values are masked). Admin-only.

Get skill configuration › path Parameters

skill_id

string · required

Get skill configuration › Responses

200

Skill configuration

skill_id

string

object[]

values

object

Current values (secrets masked as '********')

base_url

string | null

GET/api/admin/skills/{skill_id}/config

curl --request GET \
  --url http://localhost:8000/api/admin/skills/:skill_id/config

shell

Example Responses

{
  "skill_id": "skill_id",
  "schema": [
    {}
  ],
  "values": {},
  "base_url": {}
}

json

application/json

Save skill configuration

PUT

http://localhost:8000

/api/admin/skills/{skill_id}/config

Save a skill's configuration values. Masked values ('********') preserve the existing secret. Admin-only.

Save skill configuration › path Parameters

skill_id

string · required

Save skill configuration › Request Body

values

object · required

Map of variable name to value

Save skill configuration › Responses

Configuration saved

message

string

skill_id

string

PUT/api/admin/skills/{skill_id}/config

curl --request PUT \
  --url http://localhost:8000/api/admin/skills/:skill_id/config \
  --header 'Content-Type: application/json' \
  --data '{
  "values": {}
}'

shell

Example Request Body

{
  "values": {}
}

json

Example Responses

{
  "message": "message",
  "skill_id": "skill_id"
}

json

application/json

Git Integration

Cortex API

Skills

Endpoint

Agent Skills (agentskills.io) installation and configuration

List installed skills

GET

http://localhost:8000

/api/admin/skills

List all installed agent skills. Admin-only.

List installed skills › Responses

200

Installed skills retrieved

object[]

Skill summary (id, name, description, enabled, source, etc.)

Search the skills registry

GET

http://localhost:8000

/api/admin/skills/registry/search

Search the skills.sh registry for skills. Admin-only.

Search the skills registry › query Parameters

q

string · required

Search query

Search the skills registry › Responses

200

Registry search results

object[]

Registry item (namespace, name, description, install_count, download_url)

GET/api/admin/skills/registry/search

curl --request GET \
  --url 'http://localhost:8000/api/admin/skills/registry/search?q=%3Cstring%3E'

shell

Example Responses

[
  {}
]

json

application/json

Install a skill

POST

http://localhost:8000

/api/admin/skills/install

Install a skill from a direct URL or a skills.sh registry identifier. Provide exactly one of url or registry_id. Admin-only.

Install a skill › Request Body

Provide exactly one of url or registry_id.

url

string

Direct URL to SKILL.md or ZIP archive

registry_id

string

Registry identifier (namespace/name) from skills.sh

Install a skill › Responses

Skill installed

Installed skill details

POST/api/admin/skills/install

curl --request POST \
  --url http://localhost:8000/api/admin/skills/install \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "url",
  "registry_id": "registry_id"
}
'

shell

Example Request Body

{
  "url": "url",
  "registry_id": "registry_id"
}

json

Example Responses

{}

json

application/json

Discover local skills

POST

http://localhost:8000

/api/admin/skills/discover

Re-scan the local skills directory for newly added skills. Admin-only.

Discover local skills › Responses

200

Discovery completed

message

string

count

integer

POST/api/admin/skills/discover

curl --request POST \
  --url http://localhost:8000/api/admin/skills/discover

shell

Example Responses

{
  "message": "message",
  "count": 0
}

json

application/json

Get skill detail

GET

http://localhost:8000

/api/admin/skills/{skill_id}

Get full skill details including the SKILL.md body and tools config. Admin-only.

Get skill detail › path Parameters

skill_id

string · required

Get skill detail › Responses

Skill detail retrieved

Full skill detail

GET/api/admin/skills/{skill_id}

curl --request GET \
  --url http://localhost:8000/api/admin/skills/:skill_id

shell

Example Responses

{}

json

application/json

Uninstall a skill

DELETE

http://localhost:8000

/api/admin/skills/{skill_id}

Uninstall a skill and delete its files. Admin-only.

Uninstall a skill › path Parameters

skill_id

string · required

Uninstall a skill › Responses

Skill deleted

message

string

DELETE/api/admin/skills/{skill_id}

curl --request DELETE \
  --url http://localhost:8000/api/admin/skills/:skill_id

shell

Example Responses

{
  "message": "message"
}

json

application/json

Update skill settings

PATCH

http://localhost:8000

/api/admin/skills/{skill_id}

Update a skill's settings (enable/disable). Admin-only.

Update skill settings › path Parameters

skill_id

string · required

Update skill settings › Request Body

enabled

boolean | null

Enable or disable the skill

Update skill settings › Responses

Skill updated

Updated skill

PATCH/api/admin/skills/{skill_id}

curl --request PATCH \
  --url http://localhost:8000/api/admin/skills/:skill_id \
  --header 'Content-Type: application/json' \
  --data '{
  "enabled": {}
}'

shell

Example Request Body

{
  "enabled": {}
}

json

Example Responses

{}

json

application/json

Analyze skill configuration

POST

http://localhost:8000

/api/admin/skills/{skill_id}/analyze

Analyze a skill's SKILL.md with the primary LLM to extract configuration variables and API base URL. Admin-only.

Analyze skill configuration › path Parameters

skill_id

string · required

Analyze skill configuration › Responses

Analysis result

skill_id

string

object[]

base_url

string | null

POST/api/admin/skills/{skill_id}/analyze

curl --request POST \
  --url http://localhost:8000/api/admin/skills/:skill_id/analyze

shell

Example Responses

{
  "skill_id": "skill_id",
  "variables": [
    {}
  ],
  "base_url": {}
}

json

application/json

Get skill configuration

GET

http://localhost:8000

/api/admin/skills/{skill_id}/config

Get a skill's configuration schema, base URL, and current values (secret values are masked). Admin-only.

Get skill configuration › path Parameters

skill_id

string · required

Get skill configuration › Responses

200

Skill configuration

skill_id

string

object[]

values

object

Current values (secrets masked as '********')

base_url

string | null

GET/api/admin/skills/{skill_id}/config

curl --request GET \
  --url http://localhost:8000/api/admin/skills/:skill_id/config

shell

Example Responses

{
  "skill_id": "skill_id",
  "schema": [
    {}
  ],
  "values": {},
  "base_url": {}
}

json

application/json

Save skill configuration

PUT

http://localhost:8000

/api/admin/skills/{skill_id}/config

Save a skill's configuration values. Masked values ('********') preserve the existing secret. Admin-only.

Save skill configuration › path Parameters

skill_id

string · required

Save skill configuration › Request Body

values

object · required

Map of variable name to value

Save skill configuration › Responses

Configuration saved

message

string

skill_id

string

PUT/api/admin/skills/{skill_id}/config

curl --request PUT \
  --url http://localhost:8000/api/admin/skills/:skill_id/config \
  --header 'Content-Type: application/json' \
  --data '{
  "values": {}
}'

shell

Example Request Body

{
  "values": {}
}

json

Example Responses

{
  "message": "message",
  "skill_id": "skill_id"
}

json

application/json

Git Integration