Version Pinning

By default, skill_version is "latest", which resolves to the most recent revision of the skill. You can pin a specific version for reproducibility.

Latest vs Pinned

from vlmrun.client.types import AgentSkill

# Always use the latest version
skill = AgentSkill(skill_name="invoice-extraction")

# Pin a specific version
skill = AgentSkill(skill_name="invoice-extraction", skill_version="20260219-abc123")

// Always use the latest version
const skill = { skillName: "invoice-extraction" };

// Pin a specific version
const pinnedSkill = { skillName: "invoice-extraction", skillVersion: "20260219-abc123" };

When to Pin

Scenario	Recommendation
Production pipelines	Pin a specific version for consistent, reproducible results
Development and testing	Use `"latest"` to automatically pick up improvements
A/B testing	Pin different versions to compare extraction quality
Compliance workloads	Pin to ensure auditable, repeatable outputs

Version Format

Version strings follow the format YYYYMMDD-<hash>, for example 20260219-abc123. Each time a skill is updated, a new version is created with a new unique ID but the same name.

Checking Available Versions

Use the Skills API to list available versions for a skill:

from vlmrun.client import VLMRun

client = VLMRun(api_key="<VLMRUN_API_KEY>")

# Get the latest version
skill = client.agent.skills.get(name="invoice-extraction")
print(f"Latest version: {skill.skill_version}")

# Get a specific version
skill = client.agent.skills.get(name="invoice-extraction", skill_version="20260219-abc123")

Overview

Specification

Using Skills

Managing Skills

Version Pinning

Latest vs Pinned

When to Pin

Version Format

Checking Available Versions

​Latest vs Pinned

​When to Pin

​Version Format

​Checking Available Versions

Latest vs Pinned

When to Pin

Version Format

Checking Available Versions