Skip to content
Subako Docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

subako skill

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

CLI reference

subako skill

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

Usage

Usage: subako skill <COMMAND>

Subcommands

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

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

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

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

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

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

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

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.

Was this page helpful?