Beta

API ReferenceSkill

Create Skill

POSThttps://api.youvico.com/api/skills
MCP Tool
create_skillCreate Skill
Rate Limit
Tier 2
Scope
skills:write

Creates a skill.

Example

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
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"
}'
Response201 Created
{
  "data": {
    "id": "SK1234567890ABCD"
  }
}

Request

Body

namestringrequired

1-100 characters

Skill name

Example: Review Helper

descriptionstringrequired

1-1024 characters

Skill description

Example: Summarizes review context.

metadataRecord<string, string>
String metadata
allowedToolsstring[]
Allowed tool identifiers
licensestring
Skill license

Example: MIT

Response

Returns 201 Created.

dataobject
Created skill
data.idstring
ID of the created skill

Example: SK1234567890ABCD