Skip to Content
Skilder

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.

A skill's Version History dialog with three published snapshots, each showing its date, author, label and a Published status. Every row has a Compare action, and every row except the current version has a Restore action. In the picture, Alex Morgan authored all three and none has a label.

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

The Changes view in its single-column layout, on the Guidelines item of a role: the description's removed words are highlighted in red and its added words in green, and the content below is unchanged. In the picture, the role is Support Engineer.

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.

Next

  • Role and Skill, for what draft and published mean for each.

On this page