Skills

Skills group provider and integration capabilities into reusable, owned compositions.

Skills object

Attributes

object

String

id

String

status

Enum

slug

String

name

String

description

StringNullable

image_url

String

client_name

String

client_description

StringNullable

client_metadata

ObjectNullable

A key-value map

license

StringNullable

compatibility

StringNullable

metadata

Object

A key-value map

store_id

String

hierarchy

Object

integrations

Object

providers

Object

created_at

Date

updated_at

Date
{
  "object": "skill",
  "status": "active",
  "client_metadata": {},
  "metadata": {},
  "hierarchy": {
    "object": "skill.hierarchy",
    "type": "root",
    "creator": {
      "type": "organization_actor",
      "organization_actor": {
        "object": "organization.actor",
        "id": "omem_5fGhJkLmNpQrStUv",
        "type": "member",
        "organization_id": "org_7hNkPqRsTuVwXyZa",
        "name": "Alex Chen",
        "email": "[email protected]",
        "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
        "teams": [
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          },
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          }
        ]
      },
      "consumer": {
        "object": "consumer"
      }
    },
    "fork": {
      "creator": {
        "type": "organization_actor",
        "organization_actor": {
          "object": "organization.actor",
          "id": "omem_5fGhJkLmNpQrStUv",
          "type": "member",
          "organization_id": "org_7hNkPqRsTuVwXyZa",
          "name": "Alex Chen",
          "email": "[email protected]",
          "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
          "teams": [
            {
              "id": "tm_3eFgHjKlMnPqRsTu",
              "name": "Engineering",
              "slug": "engineering",
              "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
            },
            {
              "id": "tm_3eFgHjKlMnPqRsTu",
              "name": "Engineering",
              "slug": "engineering",
              "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
            }
          ]
        },
        "consumer": {
          "object": "consumer"
        }
      },
      "original_creator": {
        "type": "organization_actor",
        "organization_actor": {
          "object": "organization.actor",
          "id": "omem_5fGhJkLmNpQrStUv",
          "type": "member",
          "organization_id": "org_7hNkPqRsTuVwXyZa",
          "name": "Alex Chen",
          "email": "[email protected]",
          "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
          "teams": [
            {
              "id": "tm_3eFgHjKlMnPqRsTu",
              "name": "Engineering",
              "slug": "engineering",
              "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
            },
            {
              "id": "tm_3eFgHjKlMnPqRsTu",
              "name": "Engineering",
              "slug": "engineering",
              "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
            }
          ]
        },
        "consumer": {
          "object": "consumer"
        }
      }
    },
    "entity": {
      "object": "skill.entity"
    }
  },
  "integrations": [
    {
      "object": "integration#preview",
      "metadata": {},
      "configuration": {}
    },
    {
      "object": "integration#preview",
      "metadata": {},
      "configuration": {}
    }
  ],
  "providers": [
    {
      "object": "provider#preview",
      "id": "pro_5gHjKlMnPqRsTuVw",
      "name": "GitHub",
      "description": "Connect to GitHub repositories, issues, and pull requests",
      "slug": "github",
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    },
    {
      "object": "provider#preview",
      "id": "pro_5gHjKlMnPqRsTuVw",
      "name": "GitHub",
      "description": "Connect to GitHub repositories, issues, and pull requests",
      "slug": "github",
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    }
  ]
}

List skills

Returns a paginated list of skills.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

status

UnionOptional

id

UnionOptional

skill_group_id

UnionOptional

integration_id

UnionOptional

provider_id

UnionOptional

created_at

ObjectOptional

Filter skill creation time by date range

updated_at

ObjectOptional

Filter skill last update time by date range

GEThttp://api.metorial.com/skills
curl -X GET "https://api.metorial.com/skills" \
  -H "Authorization: Bearer metorial_sk_..."

Get skill

Retrieves a specific skill.

URL Parameters

skill_id

String

The unique identifier for the skill

GEThttp://api.metorial.com/skills/:skill_id
curl -X GET "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create skill

Creates a new skill.

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

A key-value map

client_name

StringOptional

client_description

StringOptional

license

StringOptional

compatibility

StringOptional

client_metadata

ObjectOptional

A key-value map

image_file_id

StringOptionalNullable

template_id

StringOptional
POSThttp://api.metorial.com/skills
curl -X POST "https://api.metorial.com/skills" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "client_name": "example_client_name",
  "client_description": "example_client_description",
  "license": "example_license",
  "compatibility": "example_compatibility",
  "client_metadata": {},
  "image_file_id": "example_image_file_id",
  "template_id": "example_template_id"
}'

Update skill

Updates a specific skill.

URL Parameters

skill_id

String

The unique identifier for the skill

Request Body

name

StringOptional

description

StringOptionalNullable

client_name

StringOptional

client_description

StringOptional

license

StringOptionalNullable

compatibility

StringOptionalNullable

client_metadata

ObjectOptionalNullable

A key-value map

metadata

ObjectOptionalNullable

A key-value map

image_file_id

StringOptionalNullable
PATCHhttp://api.metorial.com/skills/:skill_id
curl -X PATCH "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "client_name": "example_client_name",
  "client_description": "example_client_description",
  "license": "example_license",
  "compatibility": "example_compatibility",
  "client_metadata": {},
  "metadata": {},
  "image_file_id": "example_image_file_id"
}'

Delete skill

Archives a specific skill.

URL Parameters

skill_id

String

The unique identifier for the skill

DELETEhttp://api.metorial.com/skills/:skill_id
curl -X DELETE "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Duplicate skill

Duplicates a skill.

URL Parameters

skill_id

String

The unique identifier for the skill

Request Body

name

String

description

StringOptional

client_name

StringOptional

client_description

StringOptional

license

StringOptional

compatibility

StringOptional

client_metadata

ObjectOptional

A key-value map

metadata

ObjectOptional

A key-value map

POSThttp://api.metorial.com/skills/:skill_id/duplicate
curl -X POST "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY/duplicate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "client_name": "example_client_name",
  "client_description": "example_client_description",
  "license": "example_license",
  "compatibility": "example_compatibility",
  "client_metadata": {},
  "metadata": {}
}'