bb-bashlisted
Install: claude install-skill Orderchlorococcalesdresswhites76/bb-bash
# bb-bash: Bitbucket Cloud pull-request workflows
This skill drives the `bbb` CLI (project `bb-bash`) — a single-file bash wrapper over Bitbucket Cloud REST API 2.0. Use it whenever a task involves operating on a Bitbucket Cloud pull request from the terminal.
## Preflight
Before the first `bbb` call in a session, confirm the tool is installed and the current directory is inside a bitbucket.org repo:
```bash
command -v bbb >/dev/null || echo "bbb not on PATH"
git remote -v | grep -q bitbucket.org || echo "current repo has no bitbucket.org remote"
```
If `bbb` is missing, suggest the one-liner install:
```bash
curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/restarter/bb-bash/main/scripts/install.sh | bash
```
If the user is outside a bitbucket.org repo, set `BB_BASH_WORKSPACE` + `BB_BASH_REPO` env vars for the invocation:
```bash
BB_BASH_WORKSPACE=myorg BB_BASH_REPO=myrepo bbb pr list
```
## Command reference
### Read
```bash
bbb pr list # open PRs (default state)
bbb pr list --state=merged --author=alice
bbb pr list --state=all
bbb pr show <id> # title, branches, author, files
bbb pr diff <id> # full unified diff
bbb pr comments <id> # general + inline, with comment IDs
bbb pr checks <id> # CI statuses + Pipelines (graceful-degrade if token lacks read:pipeline)
```
### Comment
```bash
bbb pr comment <id> "general comment b