CLI reference

This page is generated from the command surface the release ships. ariadnev and av are interchangeable everywhere.

Commands in this release

• vcskill
• vcskill add-skill
• vcskill backups
• vcskill contract
• vcskill coverage
• vcskill doctor
• vcskill eval
• vcskill install
• vcskill list
• vcskill migrate
• vcskill query
• vcskill run
• vcskill run cancel
• vcskill run resume
• vcskill run status
• vcskill telemetry
• vcskill uninstall
• vcskill update
• vcskill validate

vcskill

Install a curated, quality-gated workflow kit across coding-agent targets.

Options

Options
--cwd <dir>	override project root
--dry-run	plan only, write nothing
--home <dir>	override home root
--yes	skip interactive prompts
-V, --version	output the version number

vcskill add-skill

Scaffold a new canonical skill in the kit

Arguments

• name (required)

Options

Options
--description <text>	skill description

vcskill backups

List or restore vcskill-managed backups

Arguments

• action (required) — list | restore <timestamp>
• timestamp — backup timestamp (for restore)

Options

Options
--file <rel>	restore only the file matching this name
--global	use ~/ scope

vcskill contract

Print the provider×artifact capability contract (--json for machines)

Options

Options
--json	emit JSON instead of the Markdown matrix

vcskill coverage

Strictly check classified claims against skill content

Options

Options
--skill <name>	only check one skill (bare or vc: prefixed)

vcskill doctor

Health-check the installed kit against its receipt

Options

Options
--fix	re-merge hook bindings that drifted out of settings.json (backs up first)
--global	check ~/ scope

vcskill eval

Score kit quality — tier-1 static; tier-2 behavioral suite; optional tier-3 LLM judge

Options

Options
--concurrency <count>	maximum parallel isolated runs
--deep-repeats <count>	repeats for every golden task
--model <name>	pinned model identity
--runner <json-argv>	strict JSON argv array; prompt is sent on stdin
--runtime-provider <name>	pinned runtime provider identity
--runtime-version <version>	pinned runtime version identity
--skill <name>	only evaluate one skill (bare or vc: prefixed)
--skill-repeats <count>	repeats for every skill routing cell
--suite	run the tier-2 behavioral scenario suite
--timeout-ms <milliseconds>	per-run timeout
--variant <name>	benchmark variant: vcskill or reference

vcskill install

Install the kit to one or more providers

Options

Options
--global	install to ~/ instead of ./
--provider <list>	comma-separated provider ids

vcskill list

Show kit contents and per-provider install state

Options

Options
--global	check ~/ scope

vcskill migrate

Relocate installed files when provider path conventions change

Options

Options
--global	operate on ~/ instead of ./
--provider <id>	limit to one provider

vcskill query

Show recorded vcskill history (installs | doctor | history)

Arguments

• view — installs | doctor | history

Options

This command takes no options.

vcskill run

Validate or execute a versioned graph workflow

Arguments

• workflow — canonical workflow ID

Options

Options
--initial-state <json>	initial graph state as a strict JSON object
--instruction <text>	workflow instruction
--json	emit a stable versioned JSON envelope
--model <model>	runtime model identity (stored outside Graph IR)
--run-id <id>	stable run ID (generated when omitted)
--runtime <provider>	explicit runtime: codex or claude-code
--runtime-version <version>	required runtime version (resume must match the original)
--validate	compile and lint without probing or executing

vcskill run cancel

Request cooperative cancellation for an active run

Arguments

• run-id (required) — existing run ID

Options

Options
--json	emit a stable versioned JSON envelope

vcskill run resume

Resume a durable run with the original graph and runtime identity

Arguments

• run-id (required) — existing run ID

Options

Options
--instruction <text>	workflow instruction
--json	emit a stable versioned JSON envelope
--model <model>	runtime model identity (stored outside Graph IR)
--runtime <provider>	explicit runtime: codex or claude-code
--runtime-version <version>	required runtime version (resume must match the original)

vcskill run status

Read durable status without invoking a provider

Arguments

• run-id (required) — existing run ID

Options

Options
--json	emit a stable versioned JSON envelope

vcskill telemetry

Anonymous telemetry status (stateless, off unless configured; opt out with VCSKILL_TELEMETRY_DISABLED=1)

Arguments

• action — status

Options

This command takes no options.

vcskill uninstall

Remove a previously installed kit (receipt-based, preserves user-modified files)

Options

Options
--global	uninstall from ~/ instead of ./
--provider <list>	comma-separated provider ids (default: every provider in the receipt)

vcskill update

Self-update to the latest vcskill release (--check to only report)

Options

Options
--check	only report whether an update exists; don't install
--global	check ~/ scope

vcskill validate

Lint the kit source (frontmatter, sizes, references, claim coverage) without installing

Options

Options
--check	also fail if the README provider matrix is out of sync (CI gate)