Skip to content

Validate a skill template (extract + warn on common mistakes)

POST
/skills/validate

Dry-run template validator. Returns extracted variables plus warnings about common mistakes (double-brace usage, unmatched braces).

Per the PRD lock (Q3): warn-only. We never block creation on warnings here — the user is the source of truth and a double-brace pattern is valid Jinja that voice’s runtime may handle differently from skills.

Accepts two shapes:

  1. {"template": "Hello {name}"} — one string in, vars out.
  2. {"runtime_type": "llm", "llm_config": {...}} — full skill shape, scans every template field the matching runtime would use.

Authorizations

Parameters

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

Template validation payload. {template: str} or {runtime_type, llm_config|api_config}.

object
key
additional properties
any

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string