{"id":"b9078756-358a-4251-8aba-6fac2c0fbd8a","shortId":"fJmnKK","kind":"skill","title":"bkt","tagline":"Bitbucket CLI for Data Center and Cloud. Use when users need to manage repositories, pull requests, branches, issues, webhooks, or pipelines in Bitbucket. Triggers include \"bitbucket\", \"bkt\", \"pull request\", \"PR\", \"repo list\", \"branch create\", \"Bitbucket Data Center\", \"Bitbucket ","description":"# Bitbucket CLI (bkt)\n\n`bkt` is a unified CLI for **Bitbucket Data Center** and **Bitbucket Cloud**. It mirrors `gh` ergonomics and provides structured JSON/YAML output for automation.\n\n## Before You Start\n\n**1. Verify installation** — always check before running any `bkt` command:\n\n```bash\nbkt --version\n```\n\nIf not installed:\n\n| Platform | Command |\n|----------|---------|\n| macOS/Linux | `brew install avivsinai/tap/bitbucket-cli` |\n| Windows | `scoop bucket add avivsinai https://github.com/avivsinai/scoop-bucket && scoop install bitbucket-cli` |\n| Go | `go install github.com/avivsinai/bitbucket-cli/cmd/bkt@latest` |\n| Binary | Download from [GitHub Releases](https://github.com/avivsinai/bitbucket-cli/releases) |\n\n**2. Check authentication** — most commands require an active session:\n\n```bash\nbkt auth status\n```\n\n**Bitbucket Cloud Token Requirements:**\n- Create an \"API token with scopes\" (not a general API token)\n- Select **Bitbucket** as the application\n- Required scope: **Account: Read** (`read:user:bitbucket`)\n- Additional scopes as needed: Repositories, Pull requests, Issues\n\nFor config-free use in containers and CI pipelines, see [headless authentication](rules/headless.md).\n\nIf not authenticated, log in:\n\n```bash\n# Data Center (PAT-based)\nbkt auth login https://bitbucket.example.com --username alice --token <PAT>\n\n# Bitbucket Cloud — OAuth (official binaries open browser out of the box)\nbkt auth login https://bitbucket.org --kind cloud --web\n\n# Bitbucket Cloud — API token (--web-token opens Atlassian's token creation page)\nbkt auth login https://bitbucket.org --kind cloud --web-token\n```\n\nFor source and Nix builds, set `BKT_OAUTH_CLIENT_ID` and `BKT_OAUTH_CLIENT_SECRET` env vars before running `--web`.\n\n**3. Set up a context** — contexts bind a host to a project/workspace and optional default repo, so you don't repeat flags on every command:\n\n```bash\n# Data Center\nbkt context create dc-prod --host bitbucket.example.com --project ABC --set-active\n\n# Cloud\nbkt context create cloud-team --host bitbucket.org --workspace myteam --set-active\n```\n\n## Platform Awareness\n\nSome commands are **Data Center only** or **Cloud only** — check the command reference for `*(DC)*` and `*(Cloud)*` badges. Key splits:\n\n| Feature | Data Center | Cloud |\n|---------|:-----------:|:-----:|\n| Pull requests | yes | yes |\n| Repositories | yes | yes |\n| Branches (list) | yes | yes |\n| Branches (create/delete/protect) | yes | — |\n| Issues | — | yes |\n| Pipelines | — | yes |\n| Permissions | yes | — |\n| Webhooks | yes | yes |\n| Auto-merge, tasks, reactions | yes | — |\n| Variables | — | yes |\n\nWhen a user's context is DC, do not suggest Cloud-only commands (and vice versa). If the platform is unknown, ask or check with `bkt auth status`.\n\n## Common Workflows\n\n### Create a PR from the current branch\n\n```bash\nbkt pr create --title \"feat: add caching\" --target main\n```\n\nSource branch, title, and target default to sensible values from git state. Add `--draft` for work-in-progress, `--reviewer alice` to request review.\n\n### Review cycle\n\n```bash\nbkt pr checks 42 --wait          # Wait for CI to pass\nbkt pr approve 42                # Approve\nbkt pr merge 42                  # Merge (closes source branch by default)\n```\n\n### Checkout a colleague's PR locally\n\n```bash\nbkt pr checkout 42               # Creates pr/42 branch\n```\n\n### Structured output for scripting\n\nAll commands support `--json`, `--yaml`, `--jq`, and `--template`:\n\n```bash\nbkt pr list --mine --json | jq '.[].title'\n```\n\n### Raw API escape hatch\n\nFor endpoints without a dedicated command:\n\n```bash\nbkt api /rest/api/1.0/projects --param limit=100 --json\n```\n\n## Global Flags\n\nEvery command accepts these inherited flags:\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--context` | `-c` | Use a specific named context |\n| `--json` | | JSON output |\n| `--yaml` | | YAML output |\n| `--jq` | | Apply a jq expression (requires `--json`) |\n| `--template` | | Render with Go template |\n\n## References\n\n- [headless / env vars](rules/headless.md) — Config-free CI/container auth (BKT_TOKEN, BKT_HOST) and full env var reference\n\n<!-- auto-generated by cmd/docgen — do not edit below this line -->\n\n- [admin](rules/admin.md) — Administrative operations for Bitbucket *(DC)*\n- [auth](rules/auth.md) — Manage Bitbucket authentication credentials\n- [branch](rules/branch.md) — Inspect and manage branches\n- [commit](rules/commit.md) — Work with commits\n- [context](rules/context.md) — Manage Bitbucket CLI contexts\n- [extension](rules/extension.md) — Manage bkt CLI extensions\n- [issue](rules/issue.md) — Work with Bitbucket Cloud issues *(Cloud)*\n- [perms](rules/perms.md) — Manage Bitbucket permissions *(DC)*\n- [pipeline](rules/pipeline.md) — Run and inspect Bitbucket Cloud pipelines *(Cloud)*\n- [pr](rules/pr.md) — Manage pull requests\n- [project](rules/project.md) — Work with Bitbucket projects *(DC)*\n- [repo](rules/repo.md) — Work with Bitbucket repositories\n- [status](rules/status.md) — Inspect commit and pull request statuses\n- [variable](rules/variable.md) — Manage pipeline variables *(Cloud)*\n- [webhook](rules/webhook.md) — Manage Bitbucket webhooks\n- [other](rules/other.md) — api\n\n<!-- end auto-generated -->","tags":["bkt","bitbucket","cli","avivsinai","agent-skills","ai-agents","bitbucket-cloud","bitbucket-datacenter","ci-cd","claude-code","codex","developer-tools"],"capabilities":["skill","source-avivsinai","skill-bkt","topic-agent-skills","topic-ai-agents","topic-bitbucket","topic-bitbucket-cloud","topic-bitbucket-datacenter","topic-ci-cd","topic-claude-code","topic-cli","topic-codex","topic-developer-tools","topic-devops","topic-git"],"categories":["bitbucket-cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/avivsinai/bitbucket-cli/bkt","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add avivsinai/bitbucket-cli","source_repo":"https://github.com/avivsinai/bitbucket-cli","install_from":"skills.sh"}},"qualityScore":"0.500","qualityRationale":"deterministic score 0.50 from registry signals: · indexed on github topic:agent-skills · 101 github stars · SKILL.md body (5,221 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:55:12.621Z","embedding":null,"createdAt":"2026-04-18T22:12:27.284Z","updatedAt":"2026-05-02T12:55:12.621Z","lastSeenAt":"2026-05-02T12:55:12.621Z","tsv":"'/avivsinai/bitbucket-cli/cmd/bkt@latest':109 '/avivsinai/bitbucket-cli/releases)':117 '/avivsinai/scoop-bucket':98 '/rest/api/1.0/projects':517 '1':69 '100':520 '2':118 '3':258 '42':448,458,463,480 'abc':295 'accept':526 'account':153 'activ':125,298,312 'add':94,414,430 'addit':158 'admin':577 'administr':579 'alic':196,438 'alway':72 'api':137,144,218,505,516,675 'appli':547 'applic':150 'approv':457,459 'ask':392 'atlassian':224 'auth':129,192,210,230,397,567,584 'authent':120,178,182,588 'auto':363 'auto-merg':362 'autom':65 'avivsinai':95 'avivsinai/tap/bitbucket-cli':90 'awar':314 'badg':332 'base':190 'bash':79,127,185,283,408,444,476,496,514 'binari':110,202 'bind':264 'bitbucket':2,24,27,36,39,40,49,53,102,131,147,157,198,216,582,587,604,617,624,632,645,652,671 'bitbucket-c':101 'bitbucket.example.com':194,293 'bitbucket.org':212,232,307 'bkt':1,28,42,43,77,80,128,191,209,229,244,249,286,300,396,409,445,455,460,477,497,515,568,570,610 'box':208 'branch':18,34,346,350,407,419,467,483,590,595 'brew':88 'browser':204 'bucket':93 'build':242 'c':534 'cach':415 'center':6,38,51,187,285,319,337 'check':73,119,324,394,447 'checkout':470,479 'ci':174,452 'ci/container':566 'cli':3,41,47,103,605,611 'client':246,251 'close':465 'cloud':8,54,132,199,214,217,234,299,304,322,331,338,381,618,620,633,635,667 'cloud-on':380 'cloud-team':303 'colleagu':472 'command':78,86,122,282,316,326,383,489,513,525 'commit':596,600,657 'common':399 'config':168,564 'config-fre':167,563 'contain':172 'context':262,263,287,301,374,533,539,601,606 'creat':35,135,288,302,401,411,481 'create/delete/protect':351 'creation':227 'credenti':589 'current':406 'cycl':443 'data':5,37,50,186,284,318,336 'dc':290,329,376,583,626,647 'dc-prod':289 'dedic':512 'default':272,423,469 'download':111 'draft':431 'endpoint':509 'env':253,560,574 'ergonom':58 'escap':506 'everi':281,524 'express':550 'extens':607,612 'feat':413 'featur':335 'flag':279,523,529,530 'free':169,565 'full':573 'general':143 'gh':57 'git':428 'github':113 'github.com':97,108,116 'github.com/avivsinai/bitbucket-cli/cmd/bkt@latest':107 'github.com/avivsinai/bitbucket-cli/releases)':115 'github.com/avivsinai/scoop-bucket':96 'global':522 'go':104,105,556 'hatch':507 'headless':177,559 'host':266,292,306,571 'id':247 'includ':26 'inherit':528 'inspect':592,631,656 'instal':71,84,89,100,106 'issu':19,165,353,613,619 'jq':493,502,546,549 'json':491,501,521,540,541,552 'json/yaml':62 'key':333 'kind':213,233 'limit':519 'list':33,347,499 'local':475 'log':183 'login':193,211,231 'macos/linux':87 'main':417 'manag':14,586,594,603,609,623,638,664,670 'merg':364,462,464 'mine':500 'mirror':56 'myteam':309 'name':538 'need':12,161 'nix':241 'oauth':200,245,250 'offici':201 'open':203,223 'oper':580 'option':271 'output':63,485,542,545 'page':228 'param':518 'pass':454 'pat':189 'pat-bas':188 'perm':621 'permiss':357,625 'pipelin':22,175,355,627,634,665 'platform':85,313,389 'pr':31,403,410,446,456,461,474,478,498,636 'pr/42':482 'prod':291 'progress':436 'project':294,641,646 'project/workspace':269 'provid':60 'pull':16,29,163,339,639,659 'purpos':532 'raw':504 'reaction':366 'read':154,155 'refer':327,558,576 'releas':114 'render':554 'repeat':278 'repo':32,273,648 'repositori':15,162,343,653 'request':17,30,164,340,440,640,660 'requir':123,134,151,551 'review':437,441,442 'rules/admin.md':578 'rules/auth.md':585 'rules/branch.md':591 'rules/commit.md':597 'rules/context.md':602 'rules/extension.md':608 'rules/headless.md':179,562 'rules/issue.md':614 'rules/other.md':674 'rules/perms.md':622 'rules/pipeline.md':628 'rules/pr.md':637 'rules/project.md':642 'rules/repo.md':649 'rules/status.md':655 'rules/variable.md':663 'rules/webhook.md':669 'run':75,256,629 'scoop':92,99 'scope':140,152,159 'script':487 'secret':252 'see':176 'select':146 'sensibl':425 'session':126 'set':243,259,297,311 'set-act':296,310 'short':531 'skill' 'skill-bkt' 'sourc':239,418,466 'source-avivsinai' 'specif':537 'split':334 'start':68 'state':429 'status':130,398,654,661 'structur':61,484 'suggest':379 'support':490 'target':416,422 'task':365 'team':305 'templat':495,553,557 'titl':412,420,503 'token':133,138,145,197,219,222,226,237,569 'topic-agent-skills' 'topic-ai-agents' 'topic-bitbucket' 'topic-bitbucket-cloud' 'topic-bitbucket-datacenter' 'topic-ci-cd' 'topic-claude-code' 'topic-cli' 'topic-codex' 'topic-developer-tools' 'topic-devops' 'topic-git' 'trigger':25 'unifi':46 'unknown':391 'use':9,170,535 'user':11,156,372 'usernam':195 'valu':426 'var':254,561,575 'variabl':368,662,666 'verifi':70 'versa':386 'version':81 'vice':385 'wait':449,450 'web':215,221,236,257 'web-token':220,235 'webhook':20,359,668,672 'window':91 'without':510 'work':434,598,615,643,650 'work-in-progress':433 'workflow':400 'workspac':308 'yaml':492,543,544 'yes':341,342,344,345,348,349,352,354,356,358,360,361,367,369","prices":[{"id":"67b029c4-09a7-4132-8a33-84994316bd9f","listingId":"b9078756-358a-4251-8aba-6fac2c0fbd8a","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"avivsinai","category":"bitbucket-cli","install_from":"skills.sh"},"createdAt":"2026-04-18T22:12:27.284Z"}],"sources":[{"listingId":"b9078756-358a-4251-8aba-6fac2c0fbd8a","source":"github","sourceId":"avivsinai/bitbucket-cli/bkt","sourceUrl":"https://github.com/avivsinai/bitbucket-cli/tree/master/skills/bkt","isPrimary":false,"firstSeenAt":"2026-04-18T22:12:27.284Z","lastSeenAt":"2026-05-02T12:55:12.621Z"}],"details":{"listingId":"b9078756-358a-4251-8aba-6fac2c0fbd8a","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"avivsinai","slug":"bkt","github":{"repo":"avivsinai/bitbucket-cli","stars":101,"topics":["agent-skills","ai-agents","bitbucket","bitbucket-cloud","bitbucket-datacenter","ci-cd","claude-code","cli","codex","developer-tools","devops","git","golang","pull-requests"],"license":"mit","html_url":"https://github.com/avivsinai/bitbucket-cli","pushed_at":"2026-04-28T13:56:29Z","description":"Bitbucket CLI with gh-like ergonomics","skill_md_sha":"60888f161e158d1bfe3259fea0baf71ae0fea0b2","skill_md_path":"skills/bkt/SKILL.md","default_branch":"master","skill_tree_url":"https://github.com/avivsinai/bitbucket-cli/tree/master/skills/bkt"},"layout":"multi","source":"github","category":"bitbucket-cli","frontmatter":{"name":"bkt","description":"Bitbucket CLI for Data Center and Cloud. Use when users need to manage repositories, pull requests, branches, issues, webhooks, or pipelines in Bitbucket. Triggers include \"bitbucket\", \"bkt\", \"pull request\", \"PR\", \"repo list\", \"branch create\", \"Bitbucket Data Center\", \"Bitbucket Cloud\", \"keyring timeout\"."},"skills_sh_url":"https://skills.sh/avivsinai/bitbucket-cli/bkt"},"updatedAt":"2026-05-02T12:55:12.621Z"}}