Skip to content

sb get

Download an item from SkillsBin and write it to your local filesystem, ready for Claude hot-reload.

Usage

Terminal window
sb get <slug>
sb get <project>/<slug>

Arguments

ArgumentDescription
slugThe identifier of the item to download. Required. May be project-qualified (project/slug) to disambiguate when the same slug exists in several projects.

Flags

FlagShortDefaultDescription
--output-o.Output directory for downloaded items.

Examples

Download a skill

Terminal window
sb get deploy-helper
# Downloaded Deploy Helper (skill) to deploy-helper/SKILL.md

Multi-file items (skills, plugins) bring their extra files along:

Terminal window
sb get deploy-helper
# Downloaded Deploy Helper (skill) to deploy-helper/SKILL.md
# + 2 additional file(s)

Download from a specific project

If the same slug exists in more than one project, an unqualified sb get returns the most recently updated match. Qualify the slug with the project to pick one explicitly:

Terminal window
sb get webapp/deploy-helper
# Downloaded Deploy Helper (skill) to deploy-helper/SKILL.md

Download to a custom directory

Terminal window
sb get deploy-helper -o .claude/skills
# Downloaded Deploy Helper (skill) to .claude/skills/deploy-helper/SKILL.md

Download a secret

Secrets are decrypted on the server and restored to their original filename, with owner-only permissions (0600):

Terminal window
sb get env
# Downloaded .env (secret, decrypted) to .env

See Secrets for how secret storage works.

File naming

The downloaded file name depends on the item type:

TypeFilename
skillSKILL.md
command<slug>.md
prompt<slug>.md
agent<slug>.md
specspec.md
ruleCLAUDE.md
pluginplugin.json
statusline<slug>.sh
hook<slug>.sh
mcp<slug>.json
keybinding<slug>.json
script<slug> (slug includes the extension, e.g. deploy.sh)
secretOriginal filename (e.g. .env)

Most items are written to <output-dir>/<slug>/<filename>. Two exceptions:

  • Scripts are written directly to the current directory as <slug> with executable permissions.
  • Secrets are written directly to <output-dir>/<original filename> with 0600 permissions — no per-item subfolder.

Not found

If the slug doesn’t match any item, sb get automatically searches for similar items and shows suggestions:

Terminal window
sb get deplpy-helper
# Skill 'deplpy-helper' not found.
# Did you mean one of these?
# - Deploy Helper (deploy-helper) in personal

Errors

CodeCause
NOT_FOUNDNo item with that slug exists (in the given project, if qualified).
AUTH_INVALIDToken missing or expired.
LOCAL_ERRORCould not create directory or write file.
SECRET_DECRYPT_FAILEDStored secret could not be decrypted (wrong key or tampered ciphertext).
SECRETS_NOT_CONFIGUREDThe server has no SB_SECRETS_KEY configured (self-hosted).