> ## Documentation Index > Fetch the complete documentation index at: https://developers.datagrid.com/llms.txt > Use this file to discover all available pages before exploring further. # Create skill > Create a skill. Defaults to company-owned (`account`) scope. Pass `scope: user` to create a private skill that can later be promoted. Account-scope slash keys must not collide with a built-in; use the override endpoint for that. ## OpenAPI ````yaml post /skills openapi: 3.0.3 info: version: 0.1.1 title: Datagrid API description: Datagrid API servers: - url: https://api.datagrid.com/v1 security: - BearerAuth: [] paths: /skills: post: tags: - Skills summary: Create skill description: >- Create a skill. Defaults to company-owned (`account`) scope. Pass `scope: user` to create a private skill that can later be promoted. Account-scope slash keys must not collide with a built-in; use the override endpoint for that. operationId: CreateSkill requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateSkillRequest' responses: '201': description: Created skill content: application/json: schema: $ref: '#/components/schemas/Skill' '409': description: Conflict. A company skill or built-in already uses this slash key. '429': description: >- Rate limit exceeded. Check the `Retry-After` response header and retry after the specified number of seconds. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' components: schemas: CreateSkillRequest: type: object required: - name - slash_key - instructions - category properties: name: type: string maxLength: 255 description: Display name of the skill. slash_key: type: string maxLength: 255 description: >- The slash command key (e.g. `budget-check`). Must be unique within the scope. description: type: string nullable: true maxLength: 1000 description: >- Short description. When omitted, an AI-generated description is produced from the instructions. instructions: type: string description: The full instructions / system prompt for this skill. category: type: string enum: - document_analysis - construction_project_management - financial_analysis - estimation - quality_and_safety - scheduling - contracts_and_legal - data_and_reporting - research - communication - general_productivity description: Category bucket. required_tools: type: array nullable: true items: type: string description: Tool identifiers required by this skill. preferred_tools: type: array nullable: true items: type: string description: Tool identifiers preferred by this skill. enabled: type: boolean nullable: true default: true description: Whether the skill is active. Defaults to `true`. scope: type: string nullable: true enum: - user - account default: account description: >- Ownership of the new skill. Defaults to `account` (company-owned). Pass `user` for a private skill that can later be promoted. Skill: type: object required: - object - id - scope - category - slash_key - name - description - instructions - required_tools - preferred_tools - enabled - account_id - builtin_key - promoted_at - creator_id - created_at - updated_at properties: object: type: string enum: - skill description: The object type, always 'skill'. id: type: string description: Unique identifier for the skill. scope: type: string enum: - user - account - builtin description: >- Ownership scope. `user` = private (author only), `account` = company-owned, `builtin` = global default. category: type: string enum: - document_analysis - construction_project_management - financial_analysis - estimation - quality_and_safety - scheduling - contracts_and_legal - data_and_reporting - research - communication - general_productivity description: Category bucket for grouping in the skill picker. slash_key: type: string description: >- The slash command key used to invoke this skill (e.g. `budget-check`). name: type: string description: Display name of the skill. description: type: string description: Short description shown in the skill picker. instructions: type: string description: The full instructions / system prompt for this skill. required_tools: type: array items: type: string description: Tool identifiers that this skill requires to function. preferred_tools: type: array items: type: string description: Tool identifiers that this skill works best with. enabled: type: boolean description: Whether the skill is active and available for selection. account_id: type: string nullable: true description: >- The account (company) that owns this skill. `null` for `user`-scope and `builtin` skills. builtin_key: type: string nullable: true description: >- For company overrides of built-in skills: the identifier of the underlying built-in. `null` for user-authored skills. promoted_at: type: string format: date-time nullable: true description: >- ISO timestamp when this skill was promoted to company scope. `null` for `user`-scope skills. creator_id: type: string nullable: true description: >- ID of the user who created this skill. `null` for built-in skills that have never been edited. created_at: type: string format: date-time description: ISO timestamp when this skill was created. updated_at: type: string format: date-time description: ISO timestamp when this skill was last updated. RateLimitError: type: object description: >- Returned when the rate limit is exceeded. Rate limits are enforced per teamspace, endpoint path, and HTTP method over a 60-second sliding window. Each endpoint may have its own limit — check the X-RateLimit-Limit response header for the effective value. required: - error - message - retryable - status_code properties: status_code: type: integer description: The HTTP status code (429). statusCode: type: integer deprecated: true description: Deprecated. Use status_code instead. error: type: string enum: - rate_limit_exceeded description: The error code identifying this as a rate limit error. message: type: string description: A human-readable error message. mitigation: type: string description: Suggested action to resolve the error. retryable: type: boolean description: Whether the request can be retried after a delay. details: type: object properties: reason: type: string description: A detailed explanation of why the rate limit was exceeded. securitySchemes: BearerAuth: type: http scheme: bearer ````