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.
Install a Buildkite skill from github.com/buildkite/skills.
By default, the target is auto-detected from a project .claude or .cursor folder. Use --agent to choose a target explicitly, --global to install to all existing global agent directories (~/.claude and/or ~/.cursor), or --path for another agent's skills directory.
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 |
Log HTTP API traffic to stderr; bodies may contain sensitive data |
--force |
Overwrite an existing installed skill. |
--global |
Install globally in your home directory instead of the current project. |
--org=STRING |
Organization slug for this invocation (overrides environment and configuration) |
--path=STRING |
Custom skills directory to install into, for agents such as Amp or Pi. |
Examples
Install buildkite-api into the detected project agent:
bk skill add buildkite-api
Install for Claude Code in this project:
bk skill add buildkite-api --agent claude
Install globally for Cursor:
bk skill add buildkite-api --agent cursor --global
Install into a custom skills directory, such as Amp or Pi:
bk skill add buildkite-api --path ~/.amp/skills
Update a skill
Update an installed Buildkite skill.
Update installed Buildkite skills from github.com/buildkite/skills.
If no skill name is provided, all currently installed skills for the target agent are updated.
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 |
Log HTTP API traffic to stderr; bodies may contain sensitive data |
--global |
Update the globally installed skill instead of the current project. |
--org=STRING |
Organization slug for this invocation (overrides environment and configuration) |
--path=STRING |
Custom skills directory to update, for agents such as Amp or Pi. |
Examples
bk skill update
bk skill update buildkite-api
bk skill update buildkite-api --agent claude --global
bk skill update --path ~/.amp/skills
Delete a skill
Delete an installed Buildkite skill.
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 |
Log HTTP API traffic to stderr; bodies may contain sensitive data |
--global |
Delete the globally installed skill instead of the current project. |
--org=STRING |
Organization slug for this invocation (overrides environment and configuration) |
--path=STRING |
Custom skills directory to delete from, for agents such as Amp or Pi. |
Examples
bk skill delete buildkite-api
bk skill delete buildkite-api --agent cursor --global
bk skill delete buildkite-api --path ~/.amp/skills