Skip to main content
POST
Scaffold a folder-skill (folder + SKILL.md manifest)

Authorizations

Authorization
string
header
required

Use JWT token for authentication

Body

application/json
name
string
required

Skill name. Also names the folder.

description
string

One-line description. It is what the model sees before deciding to load the skill, so phrase it as a trigger ("How to … when …"). Newlines are collapsed; truncated to 1024 characters in the catalog.

projectId
string

Optional project ID to scope the skill

parentFolderId
string

Optional parent folder ID

tags
string[]

Category tags

Response

Success

folder
object
required

The created folder, flagged as a skill. Its _id is what goes into knowledgeSkills with type: "folder".

skillDoc
object
required

The generated SKILL.md manifest document inside the folder