Skip to content

skillmaker version record

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

Computes the live design.md hash and the content hash of the whole output/ tree, and appends a skill.version_recorded event.

FlagMeaning
--label <text>Human tag for the recorded version, e.g. "v0.3"
--jsonEmit machine-readable JSON instead of text

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. ...
skillmaker: recorded version sha256:4f66bb815c24 "v0.1" for my-first-skill

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