# atmos ai skill

Use this command to manage community and custom AI skills. Install skills from GitHub repositories, list installed skills, and remove skills you no longer need.

> ⚠️ Experimental

**See also:** [AI Skills Configuration](/cli/configuration/ai/skills) for configuring skills in `atmos.yaml` |
[Skill Marketplace](/ai/skill-marketplace) for browsing available skills

## Description

Skills are specialized AI assistants that provide expert knowledge for specific domains. They follow the
[Agent Skills](https://agentskills.io) open standard and can be installed from GitHub repositories.

The `atmos ai skill` command lets you:

- Install community-contributed skills from GitHub
- List all installed skills and their status
- Remove skills you no longer need

:::tip Global `--skill` Flag
You can use installed skills with any Atmos command via the global `--skill` flag (requires `--ai`).
The skill's system prompt is sent to the AI provider for domain-specific analysis.

```shell
atmos terraform plan vpc -s ue1-prod --ai --skill atmos-terraform
```

See [Global Flags](/cli/global-flags) for details.
:::

## Usage

```shell
atmos ai skill <subcommand> [flags]
```

## Subcommands

### `atmos ai skill install`

Install a skill from a GitHub repository.

**Usage:**

```shell
atmos ai skill install <source> [flags]
```

**Flags:**

- **`--force`**
  Reinstall if the skill is already installed.
- **`-y, --yes`**
  Skip the confirmation prompt.

**Examples:**

```shell
# Install a skill from GitHub
atmos ai skill install github.com/user/skill-name

# Install a specific version
atmos ai skill install github.com/user/skill-name@v1.2.3

# Force reinstall
atmos ai skill install github.com/user/skill-name --force

# Install without confirmation
atmos ai skill install github.com/user/skill-name --yes
```

### `atmos ai skill list`

List all installed skills with their status.

**Usage:**

```shell
atmos ai skill list [flags]
```

**Flags:**

- **`-d, --detailed`**
  Show detailed information for each skill, including source, version, install date, and location.

**Examples:**

```shell
# List installed skills
atmos ai skill list

# Show detailed information
atmos ai skill list --detailed
```

### `atmos ai skill uninstall`

Remove an installed skill.

**Usage:**

```shell
atmos ai skill uninstall <name> [flags]
```

**Flags:**

- **`-f, --force`**
  Skip the confirmation prompt.

**Examples:**

```shell
# Uninstall a skill
atmos ai skill uninstall skill-name

# Uninstall without confirmation
atmos ai skill uninstall skill-name --force
```

## Related Commands