Guides

Draft a skill

Create a skill resource now and understand the revision boundary that follows.

# Draft a skill

Create a skill resource now and understand the revision boundary that follows.

A skill record is the stable administrative identity. Its instruction content belongs to immutable revisions, so an administrator can review exactly what was published and deliberately choose the active revision.

## Create the skill identity

Open Skills, choose Add skill, and provide a stable identifier, display name, and description. The browser validates the draft before sending it to the API.

## Publish content separately

Revision publishing exists in the API contract, while the rich skill editor is intentionally deferred. Activation uses If-Match against the parent skill so concurrent administrators cannot silently overwrite each other.

```text
skill identity (mutable)
  └── skill revision (immutable)
        └── optional explicit activation
```

A skill record is the stable administrative identity. Its instruction content belongs to immutable revisions, so an administrator can review exactly what was published and deliberately choose the active revision.

#Create the skill identity

Open Skills, choose Add skill, and provide a stable identifier, display name, and description. The browser validates the draft before sending it to the API.

#Publish content separately

Revision publishing exists in the API contract, while the rich skill editor is intentionally deferred. Activation uses If-Match against the parent skill so concurrent administrators cannot silently overwrite each other.

skill identity (mutable)
  └── skill revision (immutable)
        └── optional explicit activation