---
sidebar:
  label: roboto.domain.skills
  order: 14
title: roboto.domain.skills
---
Stored, versioned procedures the chat AI can apply during a conversation.

A skill is text instructions the model follows when invoked — either manually via a chat-composer chip or automatically when the model selects it from the `load_skill` tool's registry. Skills are owned by a user, optionally shared with the user's organization, and versioned in place; each version is mutable without lifecycle states. Visibility and edit rights follow the skill's accessibility: `private` (author-only), `org` (visible org-wide, author-only to edit), or `org-editable` (visible org-wide and editable by any subscribed member). Per-user subscriptions carry an `ai_version` pin that controls whether — and which version — the AI auto-invoke registry exposes to the subscriber.

## Submodules

- [roboto.domain.skills.operations](/docs/reference/python-sdk/roboto/domain/skills/operations)
- [roboto.domain.skills.record](/docs/reference/python-sdk/roboto/domain/skills/record)
- [roboto.domain.skills.skill](/docs/reference/python-sdk/roboto/domain/skills/skill)

## Package Contents

- [CreateSkillRequest](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.CreateSkillRequest) (class): Create a new skill plus its first version (`version=1`) in one call.

- [CreateSkillVersionRequest](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.CreateSkillVersionRequest) (class): Add a new version to an existing skill. The new version is assigned `MAX(version) + 1`.

- [MAX_SKILL_DESCRIPTION_LENGTH](/reference/python-sdk/roboto/domain/skills/record#roboto.domain.skills.record.MAX_SKILL_DESCRIPTION_LENGTH) (data): `MAX_SKILL_DESCRIPTION_LENGTH = 500`

- [SKILL_NAME_PATTERN](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.SKILL_NAME_PATTERN) (data): `SKILL_NAME_PATTERN = '^[A-Za-z0-9_-]+$'`

- [SetSkillSubscriptionRequest](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.SetSkillSubscriptionRequest) (class): Upsert the caller's subscription for a skill.

- [Skill](/reference/python-sdk/roboto/domain/skills/skill#roboto.domain.skills.skill.Skill) (class): An AI skill — a versioned, accessibility-scoped procedure the chat AI can apply.

- [SkillAccessibility](/reference/python-sdk/roboto/domain/skills/record#roboto.domain.skills.record.SkillAccessibility) (class): Controls who can see and edit a skill.

- [SkillListScope](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.SkillListScope) (class): Which caller-relative slice of the visible skills a list-skills query targets.

- [SkillRecord](/reference/python-sdk/roboto/domain/skills/record#roboto.domain.skills.record.SkillRecord) (class): Top-level skill identity, ownership, and visibility.

- [SkillSubscriptionRecord](/reference/python-sdk/roboto/domain/skills/record#roboto.domain.skills.record.SkillSubscriptionRecord) (class): Per-user state for a single skill.

- [SkillSummary](/reference/python-sdk/roboto/domain/skills/record#roboto.domain.skills.record.SkillSummary) (class): Compact projection of a skill plus its latest version (if any).

- [SkillVersionRecord](/reference/python-sdk/roboto/domain/skills/record#roboto.domain.skills.record.SkillVersionRecord) (class): A single, mutable version of a skill's content.

- [UpdateSkillMetadataRequest](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.UpdateSkillMetadataRequest) (class): Update top-level skill identity.

- [UpdateSkillVersionRequest](/reference/python-sdk/roboto/domain/skills/operations#roboto.domain.skills.operations.UpdateSkillVersionRequest) (class): Edit fields on an existing version (mutates in place).