# Core concepts

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

Source: https://skaas.io/docs/concepts
Last updated: 2026-11-14

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](/docs/releases) for withdrawing a single release.
