> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> The skill catalog — packaged instruction sets that compose into agent prompts at dispatch time.

**Skills** (`/platform/skills`) is the catalog of first-class skills. Each skill is a packaged `SKILL.md` plus a `forge.yaml` (allowed tools, activation mode, content addressing). At dispatch time the platform intersects the agent's permitted skills with the node's requested skills, then composes the agent prompt.

![Skills](https://mintcdn.com/gloo-b243725a/Ndtg9NEpwGc2OULA/forge/images/console/platform/skills-light.png?fit=max\&auto=format\&n=Ndtg9NEpwGc2OULA\&q=85\&s=c0c9fa98d95581af208af1b6ad7aa7df)

Skills — Forge Console at `/platform/skills`

## What you can do

* Browse the catalog by source (`builtin` / `workspace` / `marketplace` / `clawhub` / `anthropic`) and by activation mode (`always` / `on_demand`). An `anthropic` skill comes from a plugin repository Anthropic publishes; it arrives with the platform, like a `builtin` skill, and is read-only.
* Start a new skill conversationally with the **With Skill Builder** header button.
* Author a new workspace skill via the editor; review pipelines run on submit.
* **Refine** a workspace skill in place with the **Refine with Skill Builder** button on the detail page.
* Clone a `marketplace` or `clawhub` skill into the workspace with **Clone to workspace** to get an editable copy.
* Import a skill from clawhub or an external marketplace.
* Review skill quality scores — every skill gets an automated review verdict from a Judge agent.

## Creating and refining with the Skill Builder

Skills are authored the same way as Procedures and Agents — through a builder agent in a right-side conversational drawer.

* **Create from scratch.** The catalog header carries a **With Skill Builder** button that starts a fresh builder conversation in the authoring drawer.
* **Refine an existing skill.** Every skill detail page carries a **Refine with Skill Builder** button. It is **always present**, but enablement reflects the source: a `workspace` skill is editable in place, while a `builtin` / `marketplace` / `clawhub` / `anthropic` skill renders the button **disabled** with the tooltip "Built-in and marketplace skills can't be edited. Clone to a workspace copy to refine." This is the same affordance and rule used on [Procedures](https://docs.gloo.com/forge/console/platform/procedures.md) and [Agents](https://docs.gloo.com/forge/console/workforce/agents).
* **What the Skill Builder may touch.** A builder conversation acts only on the skill it was opened for, and the same holds for the Agent Builder and its agent. While that skill is still a **draft**, the Builder's reads and edits run without asking you, and finalizing still waits for approval. When you refine a **live** skill in place, every Builder edit waits for your approval, one call at a time. A request that names any other skill is refused.

## Organizing the catalog

The catalog uses the shared **collection grammar** (Search · Group · Sort · Filter · Layout).

* **Group by** — **Source** (the default: **Built-in**, **Workspace** and **Imported**, where Imported holds every `marketplace`, `clawhub` and `anthropic` skill) or **Type** (technique / pattern / reference). Grouping now **stays on while a filter is active** — it previously switched off whenever a source filter was applied.
* **Sort by** (in the **Display** popover) — **Name** within every group by default; **Updated**, **Created** and **Most used** are one click away.
* **Filter** — by **status**, by **tag**, and by **determinism level** (`L1` / `L2` / `L3` — see below).
* **Layout** — **card** (the default) or **list**.

Each card now shows a **date** and its **provenance**: a workspace skill shows its author where one is recorded, while a builtin skill — which has no author — shows "Built-in · synced ⟨date⟩" instead. Dispatch counts appear where usage data exists.

## The determinism ladder on the skill pages

Every skill sits on the **Determinism Ladder** — the platform's throughline that work *enters agentic and leaves deterministic*. The skill pages make the rung visible and derive it automatically (there is no field to set):

* **L1 · Guided** — a prose-only skill (the quiet default; no chip).
* **L2 · Scripted** — the skill ships an executable `script`-role file, materialized into the agent sandbox.
* **L3 · Procedure-calling** — the skill's instructions call one or more Procedures as agent tools.

A skill can carry both signals (scripted *and* procedure-calling); it displays as **L3** with both signals shown. The registry shows a **level chip** on each card/row, a **Determinism** filter, and **Scripted (L2)** / **Procedure-calling (L3)** stat cards.

On the detail page:

* The **Determinism** rail section names the level, its signals (Scripts / Requires sandbox / Calls procedures), and the activation mode.
* **Package Files** rows expand to a **read-only content viewer** — the D8 review can be performed in place — and state where each file materializes (`/capabilities/skills/⟨skillId⟩/⟨path⟩`). A caveat marks the current gap: scripts materialize on **workflow nodes & factory workers only — not chat/PA**.
* **Script execution (7d)** shows sandbox-run volume as explicit progress toward the promotion thresholds (25 invocations across 5 distinct dispatches). Crossing them makes the script a Procedure-promotion candidate — the analyst proposes it on its next daily pass (nothing auto-promotes). An **open proposal** links to the Attention surface to accept; once lifted, a permanent **lineage** row links the resulting Procedure.
* The **Procedures** section resolves the skill's procedure-tool references to linked Procedures and flags **grant gaps** — any assigned agent that lacks a grant the skill's instructions assume (a latent runtime failure), with a link to the agent page to remediate.

## Exemplars

The **Exemplars** section on a skill's detail page lists the cases an improved version of the skill must still pass. Each exemplar is an input and its expected output, with optional notes; JSON values are shown pretty-printed.

When an improvement starts, it freezes the current list and checks the new version against every frozen exemplar before the version is offered for approval. Editing the list later never changes an improvement that is already running.

* **Add** an exemplar with an input and an expected output. Text that starts with `{` or `[` must be valid JSON and is stored as that value; anything else is stored as text.
* **Retire** an exemplar to remove it from the list.
* **Save exemplars** sends the whole list. A skill keeps between two and five exemplars.

Editing needs the `skills:manage` permission and a **workspace** skill. Catalog skills mirror their source, so their exemplars are read-only; clone the skill to your workspace to edit them.

## Key state to watch

* **Activation mode** — `always` skills land in the prompt every dispatch; `on_demand` skills surface as a load\_skill menu entry.
* **Review status** — `approved` / `provisional` / `needs-changes` / `failed`. Failed skills don't compose.
* **Source provenance** — clones track their parent; the page shows the divergence.

## Related surfaces

* [Skill Sets](https://docs.gloo.com/forge/console/platform/skill-sets.md): bundle skills to grant together.
* [Procedures](https://docs.gloo.com/forge/console/platform/procedures.md): the code a skill can call.
* [Agents](https://docs.gloo.com/forge/console/workforce/agents): grant a skill to an agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.