Skills

Upload a skill

Creates a private skill from an upload and installs it for your account. Send one file (a .zip bundle or a lone SKILL.md), or a folder as repeated files with paths in the same order to preserve subdirectories. As JSON, send the manifest's text as skill_md, and any other files as resources. The skill is stored exactly as sent. Private skills are visible to your account only; they never enter the public catalog.

post/skills/upload

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/skills/upload
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

skill_mdstring required

The full SKILL.md text, frontmatter included, exactly as the skill's author wrote it.

resourcesobject

Other files of the skill as text, keyed by path relative to the skill's folder (e.g. references/checklist.md).

Response

The skill, installed for your account

objectstring required
idstring required
slugstring required
namestring required
descriptionstring nullable required
categorystring nullable required
tagsstring[] nullable required
versionstring required
creator_namestring nullable required
creator_avatar_urlstring nullable required
install_countinteger required
status'draft' | 'published' | 'archived' required
visibility'public' | 'private' required

private is a skill this account uploaded: only this account sees it, and it is not in the public catalog.

install_statusstring nullable required
installed_versionstring nullable required

The version this account installed. Null unless installed.

update_availableboolean required

True when the catalog version is newer than installed_version: POST /skills/{slug}/update installs it.

external_sourcestring nullable required
external_urlstring nullable required
created_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.