Core concepts

Repositories, releases, pinning, artifact kinds and channels in SKaaS, and how a skill address maps to an exact release hash.

By The SKaaS team. Last updated . Markdown version

SKaaS has a small set of concepts. Learn these six and the rest of the documentation follows.

What is a repository?

A repository is a named collection of skills inside an organization, such as acme/platform. It has a visibility, a publish policy and a list of who can read or write it. Visibility is one of private, internal (every member of the organization), unlisted (anyone who knows the address, never listed) or public (listed in the public catalog).

What is a skill address?

A skill is addressed as {org}/{repo}/{skill}, for example acme/platform/code-review. Add @sha256:{hash} to name one release: acme/platform/code-review@sha256:{hash}, where the hash is the 64 lowercase hex characters of the release hash. An address can also end in @{channel} or @{version}. The CLI takes this form. The expected_sha256 field of an MCP read takes the bare 64 characters of the hash, without the prefix.

What is a release?

A release is one published state of a skill: the SKILL.md guide and every supporting file. It is immutable. Its hash covers each file's path, content hash, size and executable bit, so two releases with the same hash hold the same bytes. An edit upstream creates a new release and leaves older ones unchanged.

What does pinning do?

Pinning means loading by hash. An assistant that loads code-review at one hash gets the same guide and files every time, whatever happens upstream later. A lockfile, skaas.lock, records the pin for a local install. To roll back, pin an earlier hash or move a channel pointer back.

What are artifact kinds?

An artifact is the thing a repository stores. Two kinds can be published today. A skill is instructions that an assistant may load and follow. A reference is material that an assistant may read but never follows as instructions. Search results carry the kind, so a client treats each hit correctly. Two more kinds, concept packs and concept nodes, are reserved names and cannot be published yet.

What are channels?

A channel is a named pointer to a release of a skill, like a distribution tag. latest always points at the newest release. stable is the conventional name for releases that passed review. draft is where the authoring endpoint saves a draft, and it never moves latest. You can add your own, and you can move a pointer back to an earlier release. A repository can also name a channel such as production that points at a snapshot: the exact release of every skill in the repository at one moment.

What states can a skill be in?

A skill is active, deprecated, archived or quarantined. An active skill is searchable and readable. A deprecated skill is readable, is left out of search, and carries a notice that names its replacement. An archived skill is left out of search and listings, and a read pinned to a release hash still works. A quarantined skill is left out everywhere, and every read is refused until an administrator lifts it. See Releases and pinning for withdrawing a single release.