> ## 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 CLI Reference
> Complete command-line reference for creating, managing, and assigning Skills programmatically with the Kubiya CLI.
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](/cli/authentication) guide if needed.
## **1. List Skill Definitions**
Shows available Skill types and their configuration schema.
**Commands**
```bash theme={null}
kubiya skill definitions
```
```bash theme={null}
kubiya skill definitions -o json
```
***
## **2. Create Skills**
Create a new Skill with metadata and configuration.
**Commands**
```bash theme={null}
kubiya skill create --name "Git Tools" --type git --enabled
```
```bash theme={null}
kubiya skill create --name "Slack Bot" --type slack --config config.json
```
```bash theme={null}
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](/core-concepts/skills/variants) for available options.
***
## **3. List Skills**
View all Skills in the control plane.
**Commands**
```bash theme={null}
kubiya skill list
```
```bash theme={null}
kubiya skill list -o json
```
***
## **4. Get Skill Details**
Fetch configuration, permissions, and associations.
**Commands**
```bash theme={null}
kubiya skill get
```
```bash theme={null}
kubiya skill get -o json
```
***
## **5. Associate Skills**
Attach a Skill to an agent, team, or environment.
**Commands**
```bash theme={null}
# Agent
kubiya skill associate agent
```
```bash theme={null}
# Team
kubiya skill associate team
```
```bash theme={null}
# Environment
kubiya skill associate environment
```
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**
```bash theme={null}
kubiya skill list-associations agent
```
```bash theme={null}
kubiya skill list-associations team
```
```bash theme={null}
kubiya skill list-associations environment
```
***
## **7. Update Skills**
Modify Skill metadata or configuration.
**Commands**
```bash theme={null}
kubiya skill update --name "New Name"
```
```bash theme={null}
kubiya skill update --enabled=false
```
```bash theme={null}
kubiya skill update --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**
```bash theme={null}
kubiya skill delete
```
Deleting a Skill removes it from all associated agents, teams, and environments. This action cannot be undone.
***
## **Common Workflows**
### Creating a Skill with Variant
```bash theme={null}
# 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
```bash theme={null}
# 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 $SKILL_ID
```
### Updating Configuration
```bash theme={null}
# Get current configuration
kubiya skill get -o json > current-config.json
# Edit the config file
# ... make changes ...
# Update the skill
kubiya skill update --config current-config.json
```
***
## **Related Pages**
See all available Skill types to create
Learn about variants for the --variant flag
Real-world CLI usage examples
Create custom Skill types