gcai skills CLI commands

`gcai skills list`

List skills

gcai skills list [--limit <number>] [--offset <number>] [--q <value>]

Flag	Type	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 for full parameter semantics.

Get a skill

gcai skills get <id>

Wraps GET /skills/{id} — see Get a skill for full parameter semantics.

Create a skill

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 for full parameter semantics.

Update a skill

gcai skills update <id> [--name <value>] [--content <value>] [--description <value>] [--file-ids <value>…]

Flag	Type	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 for full parameter semantics.

Delete a skill

gcai skills delete <id>

Wraps DELETE /skills/{id} — see Delete a skill for full parameter semantics.