Update skill

Tool update_skill · Behavior Destructive

Update a skill you can write to. Only the fields you pass change; omit a field to leave it. file_ids replaces the whole attachment set. Visibility is not editable here — manage skill sharing in the GC AI app.

Input parameters

string (uuid)

required

Skill to update. You must have write access.

string

New skill name (1-255 chars).

string

New skill instructions (1-100000 chars).

string | null

New description (max 1000 chars). Pass null or "" to clear it.

string (uuid)[]

Replacement set of attached file ids (max 50). When given, attachments are reconciled to exactly this list. Omit to leave them.

Response

object

Show properties

string (uuid)

Unique skill identifier

string

Skill name

string | null

Short description of what the skill does, or null if unset

string

The skill instructions: the prompt text the model receives when the skill runs

'private' | 'organization'

private (only the creator and users it has been explicitly shared with) or organization (visible to everyone in the org). Official skills report organization.

boolean

Whether this is an official GC AI skill. Official skills are read-only and cannot be edited or deleted via the API.

object[]

Files attached to the skill as reference context

Show properties

string (uuid)

Attached file identifier

string

Attached file name

string | null

ISO 8601 creation timestamp

string | null

ISO 8601 last-updated timestamp

Create skill

⌘I

REST

MCP

Update skill

Input parameters

Response

​Input parameters

​Response

Input parameters

Response