Use the CLI to create, inspect, assign, update, and delete Skills programmatically. This matches the standard Kubiya CLI documentation style.
1. List Skill Definitions
Shows available Skill types and their configuration schema.
Commands
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"}'
| 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 -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
Related Pages
