Templates and Skills
Guide Documentation category

Templates and Skills

Compose Agent behavior with scoped Template drafts, explicit publishing, immutable Template and Skill versions, and Agent-private overrides.

For
Template authors and Agent operators

Available documentation

Guide

Templates, Versions, Overrides, and Skills

Understand Template and Skill versions, scoped drafts, Agent overrides, and explicit updates.

Guide

Work with templates

Create and edit Organization Templates with unpublished drafts, explicit publishing, immutable versions, and pinned Skill requirements.

Concept

Manage template versions

Publish immutable Template versions from drafts, restore historical content, and explicitly update Agent pins.

Concept

Manage forks and updates

Create Organization forks through drafts and adopt newer Platform snapshots with explicit Template Updates.

Concept

Use Agent overrides

Use Agent-private Template snapshots: one mutable draft, immutable published versions, exact Skill Version requirements, direct-source updates that never change the draft, and Apply stopped or Apply & Restart running.

Concept

Work with Skills

Use Platform, Organization, and Agent-private Skill scopes, one mutable draft per lineage, immutable versions, a root SKILL.md with optional relative files, exact Agent pins, and isolated Runtime mounting.

Concept

Skill scopes

Platform Skills are globally visible; Organization Skills are Organization-visible; Agent-private Skills are visible only to their owning Agent. An Agent can use Platform, Organization, and own private Skills.

Concept

Manage Skill versions

Delete a custom lineage only when unreferenced by Agents, Templates, Overrides, or forks. Delete a non-final unreferenced version safely; built-in aai_cli lineages stay protected and Agents mount exact pins.

Documentation