Skip to main content
POST
https://api.usenotra.com
/
v1
/
skills
Create a skill
curl --request POST \
  --url https://api.usenotra.com/v1/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "humanizer",
  "description": "Polish near-final drafts so they sound natural and specific.",
  "content": "<string>"
}
'
{
  "skill": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "isSystem": true,
    "updatedAt": "<string>",
    "content": "<string>",
    "createdAt": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY.

Body

application/json
​
name
string
required

Skill name. Lowercase letters, digits, and hyphens only.

Required string length: 1 - 64
Pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$
Example:

"humanizer"

​
description
string
required

Short description of when the skill should be used.

Required string length: 1 - 1000
Example:

"Polish near-final drafts so they sound natural and specific."

​
content
string
required

Full skill instructions, typically Markdown.

Required string length: 1 - 200000

Response

Skill created successfully

​
skill
object
required
Last modified on May 30, 2026