> ## 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.

# gcai skills CLI commands

> Reference for the `gcai skills` commands in the GC AI CLI, with the synopsis and flags for each command.

## `gcai skills list`

List skills

```bash theme={null}
gcai skills list [--limit <number>] [--offset <number>] [--q <value>]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--limit <number>` | `number` | | Max items to return (default 100, max 500) |
| `--offset <number>` | `number` | | Number of items to skip (default 0) |
| `--q <value>` | `string` | | Optional case-insensitive search over skill name and description |

Wraps `GET /skills` — see [List skills](/api-reference/list-skills) for full parameter semantics.

## `gcai skills get`

Get a skill

```bash theme={null}
gcai skills get <id>
```

Wraps `GET /skills/{id}` — see [Get a skill](/api-reference/get-skill) for full parameter semantics.

## `gcai skills create`

Create a skill

```bash theme={null}
gcai skills create <name> --content <value> [--description <value>] [--visibility <private|organization>] [--file-ids <value>…]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--content <value>` | `string` | yes | The skill instructions: the prompt text the model receives when the skill runs (required, 1-100000 chars) |
| `--description <value>` | `string` | | Optional short description of what the skill does (max 1000 chars) |
| `--visibility <private\|organization>` | `private \| organization` | | Skill visibility. Defaults to `private` for user-scoped keys. Org-scoped keys always create `organization`-visible skills (they have no owning user). |
| `--file-ids <value>…` | `string[]` | | Optional uploaded file IDs to attach as reference context (max 50). Upload files first via `POST /files`. |

Wraps `POST /skills` — see [Create a skill](/api-reference/create-skill) for full parameter semantics.

## `gcai skills update`

Update a skill

```bash theme={null}
gcai skills update <id> [--name <value>] [--content <value>] [--description <value>] [--file-ids <value>…]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--name <value>` | `string` | | Updated skill name (1-255 chars) |
| `--content <value>` | `string` | | Updated skill instructions (1-100000 chars) |
| `--description <value>` | `string` | | Updated description (max 1000 chars). Pass `null` or an empty string to clear it. |
| `--file-ids <value>…` | `string[]` | | Replacement set of attached file IDs (max 50). When provided, the skill's attachments are reconciled to exactly this list. Omit to leave attachments unchanged. |

Wraps `PATCH /skills/{id}` — see [Update a skill](/api-reference/update-skill) for full parameter semantics.

## `gcai skills delete`

Delete a skill

```bash theme={null}
gcai skills delete <id>
```

Wraps `DELETE /skills/{id}` — see [Delete a skill](/api-reference/delete-skill) for full parameter semantics.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.