Get Skill Tier 4

GET/api/skills/:idCopied!

Returns skill metadata and version summaries.

Pro plan required

Skill Registry is available on the Pro plan and higher.

Example

SDK

const skill = await client.skills.get("SK1234567890ABCD");

CLI

youvico skill get --id SK1234567890ABCD

cURL

curl 'https://api.youvico.com/api/skills/SK1234567890ABCD' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": {
    "id": "SK1234567890ABCD",
    "source": "WORKSPACE",
    "name": "Review Helper",
    "description": "Summarizes review context.",
    "metadata": { "category": "review" },
    "allowedTools": ["browser"],
    "license": "MIT",
    "default": { "id": "SV1234567890ABCD" },
    "versions": [
      {
        "id": "SV1234567890ABCD",
        "version": 1,
        "note": "Initial public draft",
        "createdAt": "2026-05-28T09:00:00.000Z"
      }
    ]
  }
}

Request

Path

idstringrequired

Skill ID

Response

Returns 200 OK.

dataobject

Skill

data.idstring

Skill ID

Example: SK1234567890ABCD

data.sourcestring

Skill source

Possible values: WORKSPACEYOUVICO_MANAGED

Example: WORKSPACE

data.namestring

Skill name

Example: Review Helper

data.descriptionstring

Skill description

Example: Summarizes review context.

data.metadataRecord<string, string>?

String metadata

data.allowedToolsstring[]?

Allowed tool identifiers

data.licensestring?

Skill license

Example: MIT

data.defaultobject?

Default version

data.default.idstring

Default skill version ID

Example: SV1234567890ABCD

data.versionsarray

Published versions

data.versions[].idstring

Skill version ID

Example: SV1234567890ABCD

data.versions[].versionnumber

Version number

Example: 1

data.versions[].notestring?

Version note

Example: Initial public draft

data.versions[].createdAtstring

Version creation time

Example: 2026-05-28T09:00:00.000Z