GCgc-ai
Skills

Create a skill

Create a new skill in the caller's organization.

User-scoped keys own the skill and default it to private; org-scoped keys create organization-visible skills. Official skills cannot be created via the API.

post/skills

Request

Request body

namestring required

Skill name (required, 1-255 chars)

contentstring required

The skill instructions: the prompt text the model receives when the skill runs (required, 1-100000 chars)

descriptionstring nullable

Optional short description of what the skill does (max 1000 chars)

visibility'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_idsstring[]

Optional uploaded file IDs to attach as reference context (max 50). Upload files first via POST /files.

legal_category'commercial_contracts' | 'privacy_compliance' | 'employment' | 'procurement' | 'governance' | 'product_and_ip_counsel' | 'legal_operations' | 'real_estate_and_insurance' | 'litigation_and_disputes' | 'regulatory_and_compliance' | 'other' | 'null' nullable

Optional area of law to group the skill under. Omit or pass null to leave it uncategorized.

Example request

{
  "name": "NDA Risk Reviewer",
  "content": "Review the attached NDA and flag any clauses that deviate from our standard positions."
}

Response

The created skill

idstring uuid required

Unique skill identifier

namestring required

Skill name

descriptionstring nullable required

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

contentstring required

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

visibility'private' | 'organization' required

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

is_officialboolean required

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

legal_category'commercial_contracts' | 'privacy_compliance' | 'employment' | 'procurement' | 'governance' | 'product_and_ip_counsel' | 'legal_operations' | 'real_estate_and_insurance' | 'litigation_and_disputes' | 'regulatory_and_compliance' | 'other' | 'null' nullable required

The area of law the skill is grouped under, or null when it is uncategorized

created_atstring nullable required

ISO 8601 creation timestamp

updated_atstring nullable required

ISO 8601 last-updated timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.