---
title: blossom skill:install
url: "/docs/reference/cli/skill/install/"
canonical_url: https://docs.blossom88.com/docs/reference/cli/skill/install/
markdown_url: https://docs.blossom88.com/docs/reference/cli/skill/install.md
summary: Install the Blossom CLI AI skill
categories:
- cli
- reference
---

# blossom skill:install

Install the Blossom CLI AI skill

## Usage

    blossom skill:install [--agent AGENT] [--force]

## Flags

| Flag | Description |
| --- | --- |
| `--agent` | Agent to install for: auto, codex, claude, copilot, or all. Default: auto |
| `--force, -f` | Overwrite existing skill files |

Installs the Blossom CLI skill for AI agents.

By default, `--agent auto` installs one detected target. It chooses the first
available agent environment in this order:

1. `codex`
2. `claude`
3. `copilot`

Use `--agent all` when you intentionally want to install every supported skill
adapter.

If a skill file already exists, `skill:install` asks before overwriting in an
interactive terminal. In non-interactive use, add `--force` when overwriting is
intentional.

Examples:

    blossom skill:install
    blossom skill:install --agent codex
    blossom skill:install --agent codex --force
    blossom skill:install --agent claude
    blossom skill:install --agent copilot
    blossom skill:install --agent all