skillmaker version record

skillmaker version record <slug> [--label <text>]
skillmaker version show <slug> <hash>

Computes the live design.md hash and the content hash of the whole output/ tree, appends a skill.version_recorded event, and snapshots the version’s content into <bundle>/.skillmaker/versions/<bare-hash>/ — so a recorded version’s files can always be listed and read back later, without depending on git history.

Options

Flag	Meaning
--label <text>	Human tag for the recorded version, e.g. "v0.3"
--json	Emit machine-readable JSON instead of text

Idempotency

Recording the exact same design.md + output/ content twice is a no-op. Recording the same content under a different label is reported as a conflict (exit 1) rather than silently overwriting the earlier label:

skillmaker version record: a version was already recorded for this exact
content ("my-first-skill", sha256:4f66bb815c24) under a different label --
content is unchanged, so no new version was recorded. ...

Output

skillmaker: recorded version sha256:4f66bb815c24 "v0.1" for my-first-skill

version show

skillmaker version show <slug> <hash>

Lists a recorded version’s snapshot files. The hash may be bare or sha256:-prefixed, full or a left-anchored prefix. A version recorded before content snapshots existed gets an honest error — its content was never kept.

See also

Versions and drift for what a version hash means, how drift is computed from it, and why eval runs pin to one.