Skill Builder Import
Import a hand-written skill as a managed draft (body verbatim, no compile).
The third way a skill is born (beside suggested + authored-from-scratch): it
flows through the same review -> activate -> materialize -> evolve loop, gaining
verification, self-improvement, cross-tool sync, and versioning. A folder import
keeps the whole tree (nested folders + binary assets) verbatim. Returns the
created draft, or — when it looks like an existing active skill and force is
false — the duplicate it matched, so the user can strengthen that one instead.
Looks up by content; space-agnostic (skills list cross-space).
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Enroll the user's own skill into managed scope (the third birth).
Either paste a single-file SKILL.md (skill_md) or point at a hand-written
skill FOLDER on disk (path, from the discovery scan) to bring a multi-file
skill in whole.
Response Body
application/json
application/json
curl -X POST "https://example.com/agent/skill-builder/import" \ -H "Content-Type: application/json" \ -d '{}'{}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}