authored-skills

Preview the skill a pasted SKILL.md describes

Paste a SKILL.md and see what it would become before anything is saved: the slug, title and description Patricia read out of it, and whether this caller's import activates, needs approval, or is refused. Creates nothing. Edit the returned manifest and post it to /authored-skills/from-markdown/author, which re-validates and re-compiles it from scratch.

post/v1/authored-skills/from-markdown

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/authored-skills/from-markdown
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

namestring required

What to call the skill. Its slug is derived from this.

skill_mdstring required

The pasted SKILL.md, frontmatter and all.

Response

Successful Response

validboolean required
errorsstring[]
slugstring nullable
titlestring nullable
descriptionstring nullable
delivery_modestring nullable
manifestobject nullable
skill_mdstring nullable
semver_is_derivedboolean required

Whether Patricia derived the version. False means the source owns the version and the import details must stay unchanged.

import_outcome'activates' | 'needs_approval' | 'refused' required

The result that an imported skill will have for the current caller.

Changes

No recorded changes to this operation across all 1 revision of this API.