Skills

Create a skill

Changed on

Creates a custom skill. Names must be unique within the organization.

post/v1/skills

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/skills
  • Auth: HTTP bearer

Request body

namestring required

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

descriptionstring required

Short description of when the skill should be used.

contentstring required

Full skill instructions, typically Markdown.

Example request

{
  "name": "humanizer",
  "description": "Polish near-final drafts so they sound natural and specific.",
  "content": "# Humanizer\n\nRewrite the draft so it reads like a person wrote it. Remove filler, vary sentence length, and keep concrete details."
}

Response

Skill created successfully

Changes

  • e89be7a5ca55Revision changes
    • warning

      changed the pattern of the request property from ^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$ to ^[a-z0-9]+(?:-[a-z0-9]+)*$