# Buildkite CLI skill command

The `bk skill` command allows you to manage Buildkite skills for AI coding agents from the command line.

## Commands

| Command | Description |
| --- | --- |
| `bk skill add` | Install a Buildkite skill. |
| `bk skill update` | Update an installed Buildkite skill. |
| `bk skill delete` | Delete an installed Buildkite skill. |

## Add skill

Install a Buildkite skill.

```bash
bk skill add <name> [flags]
```

### Arguments

| Argument | Description |
| --- | --- |
| `<name>` | Name of the Buildkite skill to install (for example, buildkite-api). |

### Flags

| Flag | Description |
| --- | --- |
| `--agent=STRING` | Agent/harness to install for (claude or cursor). Auto-detected from .claude or .cursor by default. |
| `--debug` | Enable debug output for REST API calls |
| `--force` | Overwrite an existing installed skill. |
| `--global` | Install globally in your home directory instead of the current project. |
| `--path=STRING` | Custom skills directory to install into, for agents such as Amp or Pi. |

### Examples

Install buildkite-api into the detected project agent:

```bash
bk skill add buildkite-api
```

Install for Claude Code in this project:

```bash
bk skill add buildkite-api --agent claude
```

Install globally for Cursor:

```bash
bk skill add buildkite-api --agent cursor --global
```

Install into a custom skills directory, such as Amp or Pi:

```bash
bk skill add buildkite-api --path ~/.amp/skills
```

## Update skill

Update an installed Buildkite skill.

```bash
bk skill update [<name>] [flags]
```

### Arguments

| Argument | Description |
| --- | --- |
| `[<name>]` | Name of the installed Buildkite skill to update. If omitted, all installed skills are updated. |

### Flags

| Flag | Description |
| --- | --- |
| `--agent=STRING` | Agent/harness to update for (claude or cursor). Auto-detected from .claude or .cursor by default. |
| `--debug` | Enable debug output for REST API calls |
| `--global` | Update the globally installed skill instead of the current project. |
| `--path=STRING` | Custom skills directory to update, for agents such as Amp or Pi. |

### Examples

```bash
bk skill update
```

```bash
bk skill update buildkite-api
```

```bash
bk skill update buildkite-api --agent claude --global
```

```bash
bk skill update --path ~/.amp/skills
```

## Delete skill

Delete an installed Buildkite skill.

```bash
bk skill delete <name> [flags]
```

### Arguments

| Argument | Description |
| --- | --- |
| `<name>` | Name of the installed Buildkite skill to delete. |

### Flags

| Flag | Description |
| --- | --- |
| `--agent=STRING` | Agent/harness to delete from (claude or cursor). Auto-detected from .claude or .cursor by default. |
| `--debug` | Enable debug output for REST API calls |
| `--global` | Delete the globally installed skill instead of the current project. |
| `--path=STRING` | Custom skills directory to delete from, for agents such as Amp or Pi. |

### Examples

```bash
bk skill delete buildkite-api
```

```bash
bk skill delete buildkite-api --agent cursor --global
```

```bash
bk skill delete buildkite-api --path ~/.amp/skills
```