authored-skills

Author a chosen GitHub-autodetected skill

Author a candidate returned by /authored-skills/from-github. This route accepts semver_is_derived as its one preview-supplied hint because it does not hold the source bundle. The hint changes only whether Patricia refreshes identity.semver from the submitted SKILL.md and manifest. The manifest is re-validated and re-compiled through the same platform gates. The caller and archetype determine whether the version activates immediately, needs approval, or is refused. The skill remains draft-only, tenant-scoped, and recorded as source_kind='github'.

post/v1/authored-skills/from-github/author

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-github/author
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

manifestobject required

The imported manifest, including any caller edits.

skill_mdstring nullable

The imported inert SKILL.md, if it had one.

semver_is_derivedboolean

A hint that Patricia derived the version. Defaults to false so existing clients keep the manifest's own version. New clients set true only for a derived version. A wrong value cannot bypass a gate. The author route still validates and compiles the manifest.

Response

Successful Response

skill_idstring uuid required
manifest_version_idstring uuid required
slugstring required
semverstring required
titlestring required
status_codestring required
createdboolean required

Changes

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