Skill Structure

Directory Layout

<skill-name>

SKILL.md

schema.json

vlmrun.yaml

resources

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

Upload a skill zip through Create Skill. The platform extracts and stores these files. A request that references the skill loads the SKILL.md instructions and schema.json.

Inline Skill Bundles

Send a skill bundle as a base64-encoded zip in the API request. The zip must use the directory layout above.

File	Required	Description
`SKILL.md`	Yes	YAML frontmatter (`name`, `description`, etc.) followed by a markdown body with instructions
`vlmrun.yaml`	No	Skill configuration (metadata, settings, and dependencies)
`schema.json`	No	JSON Schema for structured output
`*.py`	No	Python scripts the skill can reference

For production, upload the skill and reuse it across requests.

Overview

Orion

Input & Outputs

Skills

Platform

Observability

Frameworks

Integrations

Skill Structure

Directory Layout

Inline Skill Bundles

​Directory Layout

​Inline Skill Bundles

Directory Layout

Inline Skill Bundles