Author Skill
Create a skill the user authored deliberately (top-down), from a name plus optional sources (memories and/or threads) and a free-text intent note.
Threads are resolved to their source memories via the COMPACTS_TO edge so
they flow through the same SYNTHESIZED_FROM provenance and compile context
as auto-detected evidence. The skill is created at stage promotable (ready
to compile); the caller then runs the normal compile to produce a reviewable
draft. A note-only skill (no memories/threads) is allowed: the note carries
the intent. Scoped to the personal lane (skills list cross-space).
See docs/design/SKILL_BUILDER_AND_PURPOSE.md §4.2.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
User-authored skill: a name, an optional intent note, and optional sources.
Response Body
application/json
application/json
curl -X POST "https://example.com/skills/author" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}