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": {} } ]}