Skip to content

sb search

Search for skills across your personal bin and all organizations you belong to.

Usage

Terminal window
sb search [query]

At least one of query, --type, or --project is required.

Arguments

ArgumentDescription
querySearch term. Optional when --type or --project is given.

Flags

FlagDefaultDescription
--type""Filter results by item type (skill, command, prompt, plugin, agent, statusline, spec, hook, mcp, rule, keybinding, script, secret).
--project""Filter results by project slug. Auto-detected from the git repo if omitted.

Project scoping

When run inside a git repository without --project, the search is first scoped to the project matching the repo name. If that yields no results, the search automatically retries across all your projects.

Examples

Search all items

Terminal window
sb search deploy
# Found 2 result(s) for 'deploy':
#
# deploy-helper (skill) Deploy Helper personal [project:webapp]
# A skill that helps with deployments
# deploy-check (command) Deploy Check my-org

Filter by type

Terminal window
sb search deploy --type command
# Found 1 result(s) for 'deploy':
#
# deploy-check (command) Deploy Check my-org

List everything in a project

Terminal window
sb search --project webapp
# Found 3 result(s):
#
# deploy-helper (skill) Deploy Helper personal [project:webapp]
# ci-plan (spec) CI Plan personal [project:webapp]
# env (secret) .env personal [project:webapp]

Output format

Each result shows:

  • slug — the identifier (unique within its org, project, and type)
  • type — the item type in parentheses
  • name — display name
  • binpersonal or the organization slug
  • project[project:<slug>], shown when the item belongs to a project; items without it live in the inbox

If the item has a description, it appears on the next line, indented.