Publish and version
Move a role or skill between draft and published, and restore an earlier version.
Roles and skills share one lifecycle. Edit in a draft, publish when it is ready, and everyone else's agents keep using the last published version until you do.
Publish and Restore each add a snapshot to the version history. Discard adds none. One content edit skips the draft: the content of a Markdown reference set to Live (unversioned) reaches every agent as soon as it saves (see Build a skill).
Open a draft
Click Edit on a published role or skill. Your changes autosave as you work. Nothing changes for other people's agents yet, while your own agent already sees and runs your draft.
Publish it
Click Publish, or open its menu and choose Publish with label… to name this version. Only the item's owner, if they are a contributor, or a workspace admin can publish. If an asset in the draft has no file attached, a confirm asks whether to publish it as an empty placeholder anyway.
Check it worked
The status changes from Draft to Published, and a new snapshot appears in the item's version history, with its label if you gave one (see Restore an earlier version).
Discard a draft instead
Click the discard icon next to Publish, then confirm Discard. This reverts the item to its last published state. It cannot be undone.
When someone else holds the draft
You see Take over instead of Edit. Taking over transfers the lock to you: their saved content is kept, but they can no longer edit it.
Restore an earlier version
Open the version history:
- on a skill, More options > View history
- on a role, the Versions tab
Each row is a published snapshot. While a draft is open, a DRAFT row sits on top.

Click Compare on a row to see what that version changed since the one before it.

If you are the owner and a contributor, or an admin, click Restore on an earlier snapshot to publish it again as a new snapshot. Restore discards your open draft, if you hold one, and deletes no snapshot: the version you restored from stays in the list. While someone else holds a draft, Restore is refused until you take it over. A version whose files were removed in Settings > Storage cannot be restored.
See every open draft
Open your user menu and choose Drafts. The page lists Your drafts and, when you may publish them, Other people's drafts, across both roles and skills. Tick several and click Publish selected to publish them one after another.

