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

# Create Skill

> Create a new skill in the organization



## OpenAPI

````yaml https://control-plane.kubiya.ai/api/openapi.json post /api/v1/skills
openapi: 3.1.0
info:
  title: Agent Control Plane API
  description: Multi-tenant agent orchestration with Temporal workflows
  version: 1.0.0
servers: []
security:
  - BearerAuth: []
tags:
  - name: health
    description: 🏥 **Health & Status** - Check API health and availability
  - name: authentication
    description: 🔐 **Authentication** - Token validation and auth management
  - name: agents
    description: 🤖 **Agents** - Create and manage AI agents with custom capabilities
  - name: skills
    description: 🛠️ **Tool Sets** - Manage agent skills and tool configurations
  - name: integrations
    description: 🔌 **Integrations** - Connect to external services (Kubiya managed)
  - name: custom-integrations
    description: >-
      ⚙️ **Custom Integrations** - User-defined integration instances with env
      vars, secrets, and files
  - name: integration-templates
    description: >-
      📦 **Integration Templates** - Pre-configured templates for common
      services (PostgreSQL, Redis, MongoDB, etc.)
  - name: secrets
    description: 🔑 **Secrets** - Secure credential storage and retrieval
  - name: teams
    description: 👥 **Teams** - Team management and collaboration
  - name: workflows
    description: 📊 **Workflows** - Multi-step automation and orchestration
  - name: executions
    description: ▶️ **Executions** - Track and monitor workflow runs
  - name: jobs
    description: ⏰ **Jobs** - Scheduled and webhook-triggered tasks
  - name: policies
    description: 🛡️ **Policies** - Access control and security policies
  - name: analytics
    description: 📈 **Analytics** - Usage metrics and performance monitoring
  - name: projects
    description: 📁 **Projects** - Project organization and management
  - name: environments
    description: 🌍 **Environments** - Environment configuration (dev, staging, prod)
  - name: models
    description: 🧠 **Models** - LLM model configuration and management
  - name: runtimes
    description: ⚡ **Runtimes** - Agent execution runtime environments
  - name: workers
    description: 👷 **Workers** - Worker registration and heartbeat monitoring
  - name: storage
    description: 💾 **Storage** - File storage and cloud integration
  - name: context-graph
    description: 🕸️ **Context Graph** - Knowledge graph and context management
  - name: temporal-workflows
    description: >-
      ⚙️ **Temporal Workflows** - Background workflows for context graph
      ingestion, connector operations, and scheduled jobs
  - name: templates
    description: 📝 **Templates** - Reusable configuration templates
paths:
  /api/v1/skills:
    post:
      summary: Create Skill
      description: Create a new skill in the organization
      operationId: create_skill_api_v1_skills_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ToolSetCreate'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolSetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ToolSetCreate:
      properties:
        name:
          type: string
          title: Name
          description: Skill name
        type:
          type: string
          title: Type
          description: Skill type (file_system, shell, docker, python, etc.)
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Skill description
        icon:
          anyOf:
            - type: string
            - type: 'null'
          title: Icon
          description: Icon name
          default: Wrench
        enabled:
          type: boolean
          title: Enabled
          description: Whether skill is enabled
          default: true
        configuration:
          $ref: '#/components/schemas/ToolSetConfiguration'
      type: object
      required:
        - name
        - type
      title: ToolSetCreate
    ToolSetResponse:
      properties:
        id:
          type: string
          title: Id
        organization_id:
          type: string
          title: Organization Id
        name:
          type: string
          title: Name
        type:
          type: string
          title: Type
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        icon:
          type: string
          title: Icon
        enabled:
          type: boolean
          title: Enabled
        configuration:
          additionalProperties: true
          type: object
          title: Configuration
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
        - id
        - organization_id
        - name
        - type
        - description
        - icon
        - enabled
        - configuration
        - created_at
        - updated_at
      title: ToolSetResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ToolSetConfiguration:
      properties:
        base_dir:
          anyOf:
            - type: string
            - type: 'null'
          title: Base Dir
        enable_save_file:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Save File
        enable_read_file:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Read File
        enable_list_files:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable List Files
        enable_search_files:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Search Files
        allowed_commands:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Allowed Commands
        blocked_commands:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Blocked Commands
        timeout:
          anyOf:
            - type: integer
            - type: 'null'
          title: Timeout
        enable_container_management:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Container Management
        enable_image_management:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Image Management
        enable_volume_management:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Volume Management
        enable_network_management:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Network Management
        enable_code_execution:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Code Execution
        allowed_imports:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Allowed Imports
        blocked_imports:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Blocked Imports
        enable_json_generation:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Json Generation
        enable_csv_generation:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Csv Generation
        enable_pdf_generation:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Pdf Generation
        enable_txt_generation:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Txt Generation
        output_directory:
          anyOf:
            - type: string
            - type: 'null'
          title: Output Directory
        max_diagram_size:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Diagram Size
        enable_flowchart:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Flowchart
        enable_sequence:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Sequence
        enable_class_diagram:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Class Diagram
        enable_er_diagram:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Er Diagram
        enable_gantt:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Gantt
        enable_pie_chart:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Pie Chart
        enable_state_diagram:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable State Diagram
        enable_git_graph:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Git Graph
        enable_user_journey:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable User Journey
        enable_quadrant_chart:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enable Quadrant Chart
        workflow_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Type
          description: 'Workflow type: ''json'' or ''python_dsl'''
        workflow_definition:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Definition
          description: JSON workflow definition as string
        python_dsl_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Python Dsl Code
          description: Python DSL code for workflow
        validation_enabled:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Validation Enabled
          description: Enable workflow validation
        default_runner:
          anyOf:
            - type: string
            - type: 'null'
          title: Default Runner
          description: Default runner/environment name
        custom_class:
          anyOf:
            - type: string
            - type: 'null'
          title: Custom Class
        custom_config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Custom Config
      type: object
      title: ToolSetConfiguration
      description: Configuration for a skill
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your Kubiya API token (format: Bearer <token>)'

````