---
title: "subako skill"
description: "Skills: the bundles an agent's config may grant it"
---

[CLI reference](/cli)

## `subako skill`

Skills: the bundles an agent's config may grant it

### Usage

```text
Usage: subako skill <COMMAND>
```

### Subcommands

- [`subako skill create`](#subako-skill-create)
- [`subako skill push`](#subako-skill-push)
- [`subako skill list`](#subako-skill-list)
- [`subako skill show`](#subako-skill-show)
- [`subako skill versions`](#subako-skill-versions)
- [`subako skill rename`](#subako-skill-rename)
- [`subako skill delete`](#subako-skill-delete)

### Options

#### `--help`

Print help

- Short option: `-h`.

## `subako skill create`

Create a skill in the selected workspace from a bundle directory, which becomes its version 1

### Usage

```text
Usage: subako skill create [OPTIONS] <DIR>
```

### Arguments

#### `<DIR>`

Bundle directory: the one SKILL.md sits in

- Required.

### Options

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako skill push`

Push a bundle directory as the skill's next version

### Usage

```text
Usage: subako skill push [OPTIONS] <SKILL_ID> <DIR>
```

### Arguments

#### `<SKILL_ID>`

Skill id, as `skill list` shows it

- Required.

#### `<DIR>`

Bundle directory: the one SKILL.md sits in

- Required.

### Options

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako skill list`

List the selected workspace's skills

### Usage

```text
Usage: subako skill list [OPTIONS]
```

### Options

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako skill show`

Read one skill: its name, label, and latest version

### Usage

```text
Usage: subako skill show [OPTIONS] <SKILL_ID>
```

### Arguments

#### `<SKILL_ID>`

- Required.

### Options

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako skill versions`

List a skill's versions. A pinned grant names one of these numbers

### Usage

```text
Usage: subako skill versions [OPTIONS] <SKILL_ID>
```

### Arguments

#### `<SKILL_ID>`

- Required.

### Options

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako skill rename`

Set a skill's display name. An empty one unsets it, after which the bundle's own frontmatter name stands in again

### Usage

```text
Usage: subako skill rename [OPTIONS] --display-name <DISPLAY_NAME> <SKILL_ID>
```

### Arguments

#### `<SKILL_ID>`

- Required.

### Options

#### `--display-name <DISPLAY_NAME>`

- Required.

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako skill delete`

Delete a skill and all its versions and bundles. Refused while referenced

### Usage

```text
Usage: subako skill delete [OPTIONS] <SKILL_ID>
```

### Arguments

#### `<SKILL_ID>`

- Required.

### Options

#### `--yes`

Skip the typed confirmation. For scripts that have already asked

- Default: `false`.

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.