skills

Create Skill

Create a skill from a file, prompt, or chat session.

Three creation modes (provide exactly one source): A. file_id: Use an already-uploaded skill zip (must contain SKILL.md). B. prompt (+ optional json_schema): Auto-generate SKILL.md and schema.json, package and upload. C. session_id: Retrieve chat history as the prompt, auto-generate SKILL.md.

All modes produce a skill zip stored in GCS and deduplicate by content hash.

post/v1/skills/create

Request

  • Base URL: https://api.vlm.run (the document declares no server; this is the origin it was published from)
  • URL: https://api.vlm.run/v1/skills/create
  • Auth: HTTP bearer

Request body

namestring nullable

Name of the skill (required for file_id, auto-generated for prompt/session_id)

descriptionstring nullable

Description of the skill (required for file_id, auto-generated for prompt/session_id)

file_idstring nullable

File ID from file upload API (the uploaded skill zip)

promptstring nullable

Prompt text that becomes the SKILL.md body (auto-generates skill zip)

json_schemaobject nullable

JSON schema that becomes schema.json in the skill zip

session_idstring nullable

Chat session ID to retrieve chat history as the prompt

is_publicboolean

Whether the skill is publicly accessible

Response

Successful Response

idstring required

ID of the created skill

namestring required

Name of the skill (may differ from request if LLM-generated)

descriptionstring required

Description of the skill (may differ from request if LLM-generated)

skill_versionstring required

Auto-generated version of the skill (e.g. '20260512-abc12345')

statusstring

Status of the skill creation

created_atstring date-time required

Date and time when the skill was created

updated_atstring date-time required

Date and time when the skill was updated

Changes

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