Skill Registry

Define versioned, multi-file agent skill bundles — promoted through draft/stable/live and fetched via a read-only API.

What's a skill

A Skill is a small versioned bundle of named text files (e.g. a SKILL.md plus reference docs) — the same convention Anthropic's agent skills use.

Definitions, not execution

PromptVersions never runs a skill itself — this is a governed registry your own agent code reads from, the same way it reads a prompt version.

Versioning

Every save creates a new immutable version, exactly like prompts — the file set from the last save is never mutated in place.

Promotion: draft / stable / live

Instead of dev/staging/prod, skill versions move through draft → stable → live — governance stages for a definition rather than runtime environments. Promoting to live requires the workspace owner role, same as promoting a prompt to prod.

Fetching a definition

Your agent code resolves the current definition with an API key, the same key used for the Inference API:

bash

curl https://api.promptversions.com/v1/inference/skills/SKILL_ID?version=live \
  -H "Authorization: Bearer pv_live_..."

version accepts draft, stable, live, or latest (highest version number, ignoring promotion).

Scoping an API key

API keys can be scoped to specific skill_ids in Settings → API Keys, the same way keys are scoped to specific prompts or chains.

Plan availability

The Skill Registry is available on the Pro and Team plans.

PreviousPrompt Chains NextDeployments