Skip to main content
A skill is a self-contained directory that packages instructions, a JSON schema, execution configuration, and optional resources.

​
Directory Layout

<skill-name>
SKILL.md
schema.json
vlmrun.yaml
SKILL.md — Skill metadata (YAML frontmatter) and instructions (Markdown body)vlmrun.yaml — Execution configuration: model, toolsets, and state machine graphschema.json — JSON Schema that validates the skill’s structured outputresources/ — Optional supporting files: code snippets, templates, images, or reference data
When you upload a skill as a zip file via the Create Skill endpoint, the platform extracts and stores these files. When a skill is referenced in a request, the platform loads the SKILL.md instructions and schema.json automatically.

​
Inline Skill Bundles

Instead of uploading a skill to the server, you can send a skill bundle directly in an API request as a base64-encoded zip. The zip must follow the same directory layout above. The minimum required file is SKILL.md:
FileRequiredDescription
SKILL.mdYesYAML frontmatter (name, description, etc.) followed by a markdown body with instructions
vlmrun.yamlNoSkill configuration (metadata, settings, and dependencies)
schema.jsonNoJSON Schema for structured output
*.pyNoPython scripts the skill can reference
Inline bundles are ideal for rapid prototyping and CI/CD pipelines. For production use, consider uploading the skill for reuse across requests.