authed

Create a skill

Create a new skill from a whole SKILL.md. It starts as an unpublished draft, which agents don't load until it is published with publish_skill. A name another skill already holds is refused, and a refused SKILL.md is described problem by problem; either way nothing is stored.

post/api/v1/skills

Request

  • Base URL
    https://api.teaflask.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.teaflask.com/api/v1/skills
  • Auth
    none declared

Request body

contentstring required

The whole SKILL.md: frontmatter (its name becomes the skill's unique short name, its description says when to load it), then the instructions.

Response

Successful Response

idstring uuid required

The skill's id.

organization_idstring uuid required

The organization it belongs to.

slugstring required

The skill's unique short name; an agent's configuration grants skills by it.

published_revision_idstring uuid nullable required

The revision agents load; null until the skill is first published.

descriptionstring nullable required

What the published skill is for; null until something is published.

created_atstring date-time required

When the skill was created.

updated_atstring date-time required

When the skill last changed.

Changes

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