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

# Update skill

> Update a skill you can write to.

<Info>
  **Tool** `update_skill` · **Behavior** Destructive
</Info>

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

<ParamField body="id" type="string (uuid)" required>
  Skill to update. You must have write access.
</ParamField>

<ParamField body="name" type="string">
  New skill name (1-255 chars).
</ParamField>

<ParamField body="content" type="string">
  New skill instructions (1-100000 chars).
</ParamField>

<ParamField body="description" type="string | null">
  New description (max 1000 chars). Pass null or "" to clear it.
</ParamField>

<ParamField body="file_ids" type="string (uuid)[]">
  Replacement set of attached file ids (max 50). When given, attachments are reconciled to exactly this list. Omit to leave them.
</ParamField>

## Response

<ResponseField name="skill" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string (uuid)">
      Unique skill identifier
    </ResponseField>

    <ResponseField name="name" type="string">
      Skill name
    </ResponseField>

    <ResponseField name="description" type="string | null">
      Short description of what the skill does, or null if unset
    </ResponseField>

    <ResponseField name="content" type="string">
      The skill instructions: the prompt text the model receives when the skill runs
    </ResponseField>

    <ResponseField name="visibility" type="'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`.
    </ResponseField>

    <ResponseField name="is_official" type="boolean">
      Whether this is an official GC AI skill. Official skills are read-only and cannot be edited or deleted via the API.
    </ResponseField>

    <ResponseField name="files" type="object[]">
      Files attached to the skill as reference context

      <Expandable title="properties">
        <ResponseField name="id" type="string (uuid)">
          Attached file identifier
        </ResponseField>

        <ResponseField name="name" type="string">
          Attached file name
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string | null">
      ISO 8601 creation timestamp
    </ResponseField>

    <ResponseField name="updated_at" type="string | null">
      ISO 8601 last-updated timestamp
    </ResponseField>
  </Expandable>
</ResponseField>