Create Skill Tier 4

POST/api/skillsCopied!

Creates a workspace skill.

Pro plan required

Skill Registry is available on the Pro plan and higher.
The number of skills you can create follows your plan limit.

Example

SDK

const skill = await client.skills.create({
  name: "Review Helper",
  description: "Summarizes review context.",
  metadata: { category: "review" },
  allowedTools: ["browser"],
  license: "MIT",
});

CLI

youvico skill create \
  --name "Review Helper" \
  --description "Summarizes review context." \
  --metadata '{"category":"review"}' \
  --allowed-tool browser \
  --license MIT

cURL

curl -X POST 'https://api.youvico.com/api/skills' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Review Helper", "description": "Summarizes review context.", "metadata": { "category": "review" }, "allowedTools": ["browser"], "license": "MIT" }'

{
  "data": {
    "id": "SK1234567890ABCD"
  }
}

Request

Body

namestringrequired

1-100 characters

Skill name

descriptionstringrequired

1-1024 characters

Skill description

metadataRecord<string, string>

String metadata stored with the skill

allowedToolsstring[]

Allowed tool identifiers

licensestring

Skill license

Response

Returns 201 Created.

dataobject

Created skill

data.idstring

ID of the created skill

Example: SK1234567890ABCD