roboto.domain.skills.operations

Visibility scope: Private (only the author), Org (visible to every org member, author-only to edit), or OrgEditable (visible to every org member, editable by any member who subscribes). The author can flip this later via UpdateSkillMetadataRequest.

Procedure text v1 — the instructions the model executes when this version is invoked. Bumping the version creates a new row; this field never re-edits v1’s body after the fact (use UpdateSkillVersionRequest for that).

“When to use” text for v1. Surfaces verbatim in the load_skill tool’s description so the model can decide whether to invoke this skill. Bumping the version replaces this text on the new row; this field never re-edits v1’s description after the fact.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

Skill name. Unique per org across every org-visible skill (Org and OrgEditable share one name namespace); private skills are unique per (org_id, created_by). A user’s private skill and an org-shared skill may therefore share a name without conflict. Must match SKILL_NAME_PATTERN so the name is parseable inside the chat composer’s /slug token (no whitespace, letters/digits/hyphens/underscores only).

Topic names v1’s procedure investigates (e.g. "/imu/data"), supplied by the caller. Version-scoped content — see SkillVersionRecord.relevant_topics. The SDK stores the list as given; it performs no extraction. (The Roboto web UI populates it by scanning the body for [[topic]] references, but that is a UI convenience, not an SDK guarantee — a direct caller passes whichever names the procedure investigates.) Edit later via UpdateSkillVersionRequest.relevant_topics.

Initial set of tags. Edits after creation flow through UpdateSkillMetadataRequest.put_tags / .remove_tags so concurrent updates merge cleanly — see SkillRecord.tags.

Procedure text the model executes when this version is invoked.

“When to use” text for this version. Surfaces verbatim in the load_skill tool’s description on every turn this version is offered to the AI.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

Topic names this version’s procedure investigates. Version-scoped content — see SkillVersionRecord.relevant_topics.

Pinned AI-available version. None means “subscribed, but not exposed to AI”.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

Org-shared skills authored by someone else, regardless of whether the caller has subscribed.

Skills the caller authored or has subscribed to — their personal set.

New visibility scope. Omit to leave unchanged. Author-only — a subscribed non-author editor of an OrgEditable skill cannot change it. Flipping Private → Org / OrgEditable immediately exposes the skill to every org member; flipping to Private prunes every non-author subscription.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

New skill name. Omit (the NotSet default) to leave unchanged. Must match SKILL_NAME_PATTERN and stays unique per org (private skills per author).

Tags to add. Empty (the default) means “no change to tags.” Additive semantics — does not clear other tags.

Tags to remove. Empty (the default) means “no change to tags.” Removing a tag the skill doesn’t have is a no-op.

New procedure text. Omit (the NotSet default) to leave unchanged. The change applies in place to this version — subscribers pinned to it will see the new body on their next AI invocation; there is no per-edit revision.

New “when to use” text. Omit (the NotSet default) to leave unchanged.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

New topic-name list. Omit (the NotSet default) to leave unchanged; pass an empty list to clear all topics. Version-scoped content — see SkillVersionRecord.relevant_topics.