Draft vs. Published

Skill versions are either draft or published (skillVersionSchema.status / isPublished).

• Draft - editable; used for preview and evaluations that target draft lines (draftVersionId on evaluation runs).
• Published - immutable baseline for production-style runs; publishedVersion on list items surfaces the current published ref.

POST /api/skills/:id/publish promotes a version. When a run omits skillVersionId, the runtime resolves to the published version by default.

See also

• Publish A Version
• Draft vs. Published Comparison