authored-skills

Author an instruction skill from a pasted SKILL.md (default editor)

Create or update an instruction skill from a single pasted (or imported) SKILL.md: optional YAML front matter (name, description) then plain-markdown instructions. Parsed server-side into the SAME 'instructions' archetype as the typed path. An owner or admin author's version is ready to enable immediately; a version authored without that authority needs an owner or admin's approval first. The version is managed automatically. The raw markdown is preserved verbatim for later editing.

post/v1/authored-skills/instructions/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/instructions/markdown
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

markdownstring required

The skill's SKILL.md: optional --- front matter (name, description) then markdown instructions.

recommended_integrationsstring[]

App slugs from the integrations catalog to recommend connecting for this skill.

skill_idstring uuid nullable

When editing an existing instruction skill, its id. An edit targets this skill and keeps its identity even if the name changed. Omit when creating a new skill.

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.