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

# Skills

> System-level capabilities that define what your agents can do. From file operations to Docker management, Skills provide controlled, secure access to essential functionalities.

<img className="block dark:hidden" src="https://mintcdn.com/kubiya/MiR-TpFZ5R_gB8wu/assets/screenshots/composer/skills.png?fit=max&auto=format&n=MiR-TpFZ5R_gB8wu&q=85&s=4f6dc938958e2538bb0fbab1803a5966" alt="Skills Dashboard" width="1600" height="942" data-path="assets/screenshots/composer/skills.png" />

<img className="hidden dark:block" src="https://mintcdn.com/kubiya/MiR-TpFZ5R_gB8wu/assets/screenshots/composer/skills.png?fit=max&auto=format&n=MiR-TpFZ5R_gB8wu&q=85&s=4f6dc938958e2538bb0fbab1803a5966" alt="Skills Dashboard - Dark Mode" width="1600" height="942" data-path="assets/screenshots/composer/skills.png" />

Skills are the building blocks of agent capabilities in Kubiya. They define what actions your agents can perform—from reading files and executing shell commands to managing Docker containers and orchestrating multi-agent workflows.

<CardGroup cols={3}>
  <Card title="Built-in Skills" icon="box">
    Ready-to-use capabilities for common operations
  </Card>

  <Card title="Security First" icon="shield-check">
    Variants for different permission levels
  </Card>

  <Card title="Fully Extensible" icon="puzzle-piece">
    Create custom Skills for your needs
  </Card>
</CardGroup>

***

## Why Skills Matter

<AccordionGroup>
  <Accordion title="🎯 Controlled Capabilities" icon="sliders">
    Skills define **what agents can do** with precise control over permissions. An agent with "Shell - Safe Commands" can only run approved diagnostic commands, while "Shell - Full Access" enables any command execution.
  </Accordion>

  <Accordion title="🔒 Security Boundaries" icon="lock">
    Built-in security variants follow the **principle of least privilege**. Start with read-only or safe variants, then expand permissions only as needed. Sandboxed environments provide additional isolation.
  </Accordion>

  <Accordion title="🔌 Easy Integration" icon="plug">
    Create custom Skills to integrate with proprietary APIs, services, and tools. Skills make your organization's unique capabilities available to agents.
  </Accordion>
</AccordionGroup>

***

## Get Started

<Steps>
  <Step title="Choose a Skill Type">
    Select from **built-in Skills** or create a custom one:

    * **File System** - Read, write, and manage files
    * **Shell** - Execute commands with configurable restrictions
    * **Python** - Run Python code with import controls
    * **Docker** - Manage containers, images, and networks
    * **Agent Communication** - Enable multi-agent orchestration
    * **And more...**

    <Card title="View All Built-in Skills" icon="arrow-right" href="/core-concepts/skills/built-in-skills">
      Explore the complete reference with use cases and configuration options
    </Card>
  </Step>

  <Step title="Select a Variant">
    Pick a pre-configured security level:

    <Tabs>
      <Tab title="Safe / Read-Only">
        **Minimal permissions** for monitoring and observation

        * No write or destructive actions
        * Perfect for audit and compliance
        * Example: Read-only file access for log monitoring
      </Tab>

      <Tab title="Limited (Default)">
        **Balanced permissions** for most use cases

        * Restricted command sets
        * Sandboxed environments available
        * Example: Safe shell commands for diagnostics
      </Tab>

      <Tab title="Full Access">
        **Maximum permissions** for power users

        * Complete control when needed
        * Use with caution in production
        * Example: Full Docker management for deployments
      </Tab>
    </Tabs>

    <Card title="Learn About Variants" icon="arrow-right" href="/core-concepts/skills/variants">
      Understand how to choose the right variant for your use case
    </Card>
  </Step>

  <Step title="Create & Assign">
    Create a Skill instance and attach it to agents or teams:

    ```bash theme={null}
    # Create a skill with a specific variant
    kubiya skill create \
      --name "Production Shell" \
      --type shell \
      --variant safe_commands \
      --enabled

    # Assign to an agent
    kubiya skill associate agent <agent-id> <skill-id>
    ```

    <CardGroup cols={2}>
      <Card title="CLI Reference" icon="terminal" href="/core-concepts/skills/cli-reference">
        Complete command documentation
      </Card>

      <Card title="View Examples" icon="lightbulb" href="/core-concepts/skills/examples">
        Real-world configurations
      </Card>
    </CardGroup>
  </Step>
</Steps>

***

## Explore Skills

<CardGroup cols={2}>
  <Card title="Skills Overview" icon="book-open" href="/core-concepts/skills/overview" color="#0EA5E9">
    **Comprehensive guide** to understanding and managing Skills

    Learn about the Skills lifecycle, UI workflow, best practices, and troubleshooting
  </Card>

  <Card title="Built-in Skills Reference" icon="layer-group" href="/core-concepts/skills/built-in-skills" color="#8B5CF6">
    **Complete catalog** of all built-in Skills

    File System, Shell, Python, Docker, Workflows, Agent Communication, and more
  </Card>

  <Card title="Skill Variants Guide" icon="code-branch" href="/core-concepts/skills/variants" color="#10B981">
    **Master security variants** and skill instances

    Learn how to create properly configured instances following least privilege
  </Card>

  <Card title="Custom Skills" icon="wrench" href="/core-concepts/skills/custom-skills" color="#F59E0B">
    **Extend Kubiya** with custom capabilities

    Step-by-step guide to creating Skills with .kubiya/skills directory
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/core-concepts/skills/cli-reference" color="#EF4444">
    **Command-line tools** for Skills management

    Create, list, update, delete, and associate Skills programmatically
  </Card>

  <Card title="Real-World Examples" icon="lightbulb" href="/core-concepts/skills/examples" color="#EC4899">
    **Practical configurations** and patterns

    Production deployments, monitoring agents, sandbox environments, and more
  </Card>
</CardGroup>

***

## Common Use Cases

<CardGroup cols={3}>
  <Card title="Production Deployment" icon="rocket">
    **Skills:** Shell (Safe Commands), File System (Full Access), Docker (Full Control)

    Enable controlled deployments with restricted command execution
  </Card>

  <Card title="Monitoring & Observability" icon="chart-line">
    **Skills:** File System (Read Only), Shell (Read Only), Data Visualization

    Observe systems without risk of accidental changes
  </Card>

  <Card title="Development Sandbox" icon="flask">
    **Skills:** File System (Sandboxed), Shell (Full Access), Python (Full Access)

    Give developers freedom to experiment in isolated environments
  </Card>

  <Card title="Multi-Agent Orchestration" icon="diagram-project">
    **Skills:** Agent Communication (Limited), Workflow Executor

    Coordinate complex workflows across specialist agents
  </Card>

  <Card title="Custom Integrations" icon="plug-circle-check">
    **Skills:** Custom Skills (Slack, GitHub, JIRA, etc.)

    Connect agents to your organization's tools and APIs
  </Card>

  <Card title="Audit & Compliance" icon="clipboard-check">
    **Skills:** All Skills (Read Only variants)

    Ensure agents can observe but never modify critical systems
  </Card>
</CardGroup>

***

## Best Practices

<Note>
  **Security First**: Always start with the most restrictive variant that meets your needs. You can upgrade permissions later if required.
</Note>

<CardGroup cols={2}>
  <Card title="Principle of Least Privilege" icon="shield-halved">
    Only grant the minimum permissions required for the task
  </Card>

  <Card title="Use Pre-configured Variants" icon="stamp">
    Leverage built-in templates instead of custom configurations
  </Card>

  <Card title="Test in Development First" icon="vial">
    Validate Skill configurations before deploying to production
  </Card>

  <Card title="Document Custom Skills" icon="file-lines">
    Include clear descriptions and usage instructions
  </Card>
</CardGroup>

***

## Quick Links

<CardGroup cols={4}>
  <Card title="Overview" icon="book" href="/core-concepts/skills/overview" />

  <Card title="Built-in Skills" icon="layer-group" href="/core-concepts/skills/built-in-skills" />

  <Card title="Variants" icon="code-branch" href="/core-concepts/skills/variants" />

  <Card title="Custom Skills" icon="wrench" href="/core-concepts/skills/custom-skills" />

  <Card title="CLI" icon="terminal" href="/core-concepts/skills/cli-reference" />

  <Card title="Examples" icon="lightbulb" href="/core-concepts/skills/examples" />

  <Card title="Agents" icon="robot" href="/core-concepts/agents" />

  <Card title="Teams" icon="users" href="/core-concepts/teams" />
</CardGroup>
