Skills CLI Reference

Use the CLI to create, inspect, assign, update, and delete Skills programmatically. This matches the standard Kubiya CLI documentation style.

All commands require proper authentication. See the CLI Authentication guide if needed.

1. List Skill Definitions

Shows available Skill types and their configuration schema. Commands

kubiya skill definitions

kubiya skill definitions -o json

2. Create Skills

Create a new Skill with metadata and configuration. Commands

kubiya skill create --name "Git Tools" --type git --enabled

kubiya skill create --name "Slack Bot" --type slack --config config.json

kubiya skill create --name "AWS CLI" --type aws --config-json '{"region":"us-east-1"}'

Flags

Flag	Description
`--name`	Skill name (required)
`--type`	Skill type (required)
`--description`	Description string
`--enabled`	Enable immediately
`--config`	Load config JSON from file
`--config-json`	Inline JSON configuration
`--variant`	Optional type variant
`-o, --output`	Output format (json, yaml)

Use the --variant flag to create Skills with pre-configured templates. See Skill Variants for available options.

3. List Skills

View all Skills in the control plane. Commands

kubiya skill list

kubiya skill list -o json

4. Get Skill Details

Fetch configuration, permissions, and associations. Commands

kubiya skill get <skill-id>

kubiya skill get <skill-id> -o json

5. Associate Skills

Attach a Skill to an agent, team, or environment. Commands

# Agent
kubiya skill associate agent <agent-id> <skill-id>

# Team
kubiya skill associate team <team-id> <skill-id>

# Environment
kubiya skill associate environment <env-id> <skill-id>

Skills can be associated with multiple entities. The same Skill instance can be shared across agents, teams, and environments.

6. List Skill Associations

See all Skills attached to a specific entity. Commands

kubiya skill list-associations agent <agent-id>

kubiya skill list-associations team <team-id>

kubiya skill list-associations environment <env-id>

7. Update Skills

Modify Skill metadata or configuration. Commands

kubiya skill update <skill-id> --name "New Name"

kubiya skill update <skill-id> --enabled=false

kubiya skill update <skill-id> --config-json '{"commands":["ls","cat"]}'

Updating a Skill’s configuration affects all agents, teams, and environments where it’s assigned. Test changes carefully in non-production environments first.

8. Delete Skills

Remove Skills that are no longer required. Commands

kubiya skill delete <skill-id>

Deleting a Skill removes it from all associated agents, teams, and environments. This action cannot be undone.

Common Workflows

Creating a Skill with Variant

# Create a read-only file system skill
kubiya skill create \
  --name "Production Logs Reader" \
  --type file_system \
  --variant read_only \
  --description "Read-only access to production logs" \
  --enabled

Creating and Assigning in One Flow

# 1. Create the skill
SKILL_ID=$(kubiya skill create \
  --name "Dev Shell" \
  --type shell \
  --variant safe_commands \
  -o json | jq -r '.id')

# 2. Associate with an agent
kubiya skill associate agent <agent-id> $SKILL_ID

Updating Configuration

# Get current configuration
kubiya skill get <skill-id> -o json > current-config.json

# Edit the config file
# ... make changes ...

# Update the skill
kubiya skill update <skill-id> --config current-config.json

Built-in Skills

See all available Skill types to create

Skill Variants

Learn about variants for the —variant flag

Examples

Real-world CLI usage examples

Custom Skills

Create custom Skill types

Introduction

Quick Start

Web Interface

Core Concepts

Infrastructure

Skills CLI Reference

1. List Skill Definitions

2. Create Skills

3. List Skills

4. Get Skill Details

5. Associate Skills

6. List Skill Associations

7. Update Skills

8. Delete Skills

Common Workflows

Creating a Skill with Variant

Creating and Assigning in One Flow

Updating Configuration

Built-in Skills

Skill Variants

Examples

Custom Skills

​1. List Skill Definitions

​2. Create Skills

​3. List Skills

​4. Get Skill Details

​5. Associate Skills

​6. List Skill Associations

​7. Update Skills

​8. Delete Skills

​Common Workflows

​Creating a Skill with Variant

​Creating and Assigning in One Flow

​Updating Configuration

​Related Pages

Built-in Skills

Skill Variants

Examples

Custom Skills

1. List Skill Definitions

2. Create Skills

3. List Skills

4. Get Skill Details

5. Associate Skills

6. List Skill Associations

7. Update Skills

8. Delete Skills

Common Workflows

Creating a Skill with Variant

Creating and Assigning in One Flow

Updating Configuration

Related Pages