Skills

Update a skill

Changed on

Updates the name, description, or content of a skill. System skills can be edited but not renamed.

patch/v1/skills/{name}

Request

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

Path parameters

namestring required

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

Example:humanizer

Request body

namestring

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

descriptionstring

Short description of when the skill should be used.

contentstring

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 updated successfully

Changes

  • e89be7a5ca55Revision changes
    • warning

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

    • 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]+)*$