Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt.

MITAuto-check passedDevelopment

Install Bkt

skills CLI
$ npx skills add avivsinai/bitbucket-cli --skill bkt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install avivsinai/bitbucket-cli bkt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/avivsinai/bitbucket-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bkt .claude/skills/bkt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bkt
GitHub stars
233
Used in
1 other repo
Token cost
~1k tokens
SKILL.md length
371 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt.

  • A request names Bitbucket
  • SKILL.md covers Start with the requested…, Route to the command reference, Mutation and credential… and References
  • Needs BKT_OAUTH_CLIENT_SECRET
  • Confirm the platform before platform-specific commands

What it does

Bkt is an agent skill from avivsinai/bitbucket-cli. Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt. Use when a request names Bitbucket or bkt; confirm the platform before platform-specific commands.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Pull requests and Webhooks. It works with Bitbucket, Git and Go. The repository describes itself as: Bitbucket CLI with gh-like ergonomics. The licence is MIT.

When your agent uses it

  • A request names Bitbucket
  • Confirm the platform before platform-specific commands

Example prompts

  • “/bkt”

Requirements

  • A credential in BKT_OAUTH_CLIENT_SECRET

What it can do on your machine

Read from SKILL.md and the folder at commit 68e5e47. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BKT_OAUTH_CLIENT_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bkt loads about 1k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 371 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from avivsinai/bitbucket-cli at commit 68e5e47, republished under its MIT licence (© avivsinai). 371 words, ~1,003 tokens.

Download SKILL.mdSave it as .claude/skills/bkt/SKILL.md (or your agent's skills folder).
name
bkt
description
Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt. Use when a request names Bitbucket or bkt; confirm the platform before platform-specific commands.
version
0.32.1
metadata.short-description
Bitbucket CLI for repos, PRs, branches
metadata.compatibility
claude-code, codex-cli

Bitbucket CLI (bkt)

Use bkt for Bitbucket Cloud and Data Center operations. Prefer structured --json, --yaml, --jq, or --template output for automation.

Start with the requested operation

Run bkt --version only when installation or compatibility is uncertain. Run bkt auth status when the command needs authentication or the active platform and context are unknown. Do not make setup a prerequisite for an already configured read-only request.

Cloud and Data Center have different feature sets. Determine the platform from the active context or ask when it cannot be inferred. Do not suggest a Cloud-only command for Data Center, or the reverse.

Read setup and common workflows when installing, authenticating, creating a context, or learning the main command patterns. For config-free CI or containers, read headless authentication.

Route to the command reference

Read only the reference for the requested command group:

Mutation and credential boundaries

  • Listing, viewing, status, and checks are read-only. Create, edit, approve, merge, delete, rerun, or permission changes modify Bitbucket; perform them only when the user requested that change.
  • Never place tokens, OAuth secrets, or passwords in commands that could enter logs or committed files. Use the CLI's supported credential flow or environment variables described in the auth references.
  • Official release binaries embed the Cloud browser-OAuth consumer credentials. Do not remove that behavior as generic hardening. Source and Nix builds may require BKT_OAUTH_CLIENT_ID and BKT_OAUTH_CLIENT_SECRET.
  • Before a merge or other consequential write, inspect the exact target, repository, and current checks. Report the resulting URL or identifier.
Show full SKILL.md (108 more words)Show less

References

<!-- auto-generated by cmd/docgen — do not edit below this line -->
  • admin — Administrative operations for Bitbucket (DC)
  • auth — Manage Bitbucket authentication credentials
  • branch — Inspect and manage branches
  • commit — Work with commits
  • context — Manage Bitbucket CLI contexts
  • extension — Manage bkt CLI extensions
  • issue — Work with Bitbucket Cloud issues (Cloud)
  • mcp — Model Context Protocol server for agents
  • perms — Manage Bitbucket permissions (DC)
  • pipeline — Run and inspect Bitbucket Cloud pipelines (Cloud)
  • pr — Manage pull requests
  • project — Work with Bitbucket projects (DC)
  • repo — Work with Bitbucket repositories
  • skill — Install and manage agent skills
  • status — Inspect commit and pull request statuses
  • variable — Manage pipeline variables (Cloud)
  • webhook — Manage Bitbucket webhooks
  • other — api
<!-- end auto-generated -->

© avivsinai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/bkt of avivsinai/bitbucket-cli.

Open the folder on GitHubat commit 68e5e47

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in avivsinai/bitbucket-cli, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bkt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bkt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bkt this skillavivsinai/bitbucket-cli2331 repos~1kAutomated safety check: PassMIT
Code Reviewyaklang/yakit7.8k—~1.5kAutomated safety check: NotesAGPL-3.0
Create PRyaklang/yakit7.8k—~2.1kAutomated safety check: PassAGPL-3.0
Commit Msgyaklang/yakit7.8k—~833Automated safety check: PassAGPL-3.0
Publish Pull Request for taskctltaskctl/taskctl434—~979Automated safety check: PassGPL-3.0
Conventional Gitblackfyre/wga194—~843Automated safety check: PassApache-2.0

Similar skills

  • Code Review

    yaklang/yakit

    对 Yakit 仓库的代码改动做规范化 code review:按代码逻辑、TS 定义、UI 引用与 Props、CSS 样式、依赖版本、配置项六个维度审查,检查测试用例缺失,强制执行 tsc 类型检查与 vitest 测试验证,输出「结果汇总 / 明细解释 / 合并结论」三块报告,经用户确认后写入文件。当用户要求 review、审查、评审代码改动,或在提交、合并、提 PR…

    7.8k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Create PR

    yaklang/yakit

    为 Yakit 仓库一站式完成提 PR 流程:提交工作区改动、调用 code-review skill 评审、推送远端后在 yaklang/yakit 创建或更新 PR。当用户要求提 PR、提交 PR、创建 PR、发 PR、raise/submit/open PR、"create PR"、更新已有 PR,或使用 /create-pr 时触发。

    7.8k GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Commit Msg

    yaklang/yakit

    为 Yakit 仓库完成一次本地提交:确定提交范围(暂存区优先,空则弹框确认)、基于 diff 按改动类型归纳中文 message(每种类型一行)、commit 前弹窗确认、执行 git commit(不推送)。只要 message 时仅输出文本。用户说「提交」「commit 代码」或输入 /commit-msg,或被 create-pr 等 skill 调用时使用。

    7.8k GitHub stars~833 tokensUpdated today
    DevelopmentAuto-check passed
  • Publishes the current branch and opens or updates a GitHub pull request for the taskctl repo, after a pre-publish gate and with a description template matched to the change.

    434 GitHub stars~979 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Conventional Git

    blackfyre/wga

    Creates Conventional Commit messages and matching pull-request titles and branch names.

    194 GitHub stars~843 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Deskcomm Contribuir

    melgarafael/DeskcommCRM

    Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull request, sobretudo de um fork.

    4.5k GitHub stars~3.6k tokensUpdated today
    DevelopmentAuto-check: notes

Works with

Questions about Bkt

What does Bkt do?

Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt. Bkt is an agent skill from avivsinai/bitbucket-cli. Operate Bitbucket Cloud or Data Center repositories, pull requests, branches, issues, pipelines, permissions, and webhooks with bkt.

When should I use Bkt?

Bkt fits situations like: A request names Bitbucket; confirm the platform before platform-specific commands.

How do I install Bkt in Claude Code?

Run `npx skills add avivsinai/bitbucket-cli --skill bkt -a claude-code`. Or copy the skill folder (skills/bkt in avivsinai/bitbucket-cli) into .claude/skills/bkt in your project. Claude Code loads it when a task matches its description.

How do I install Bkt in Codex?

Run `npx skills add avivsinai/bitbucket-cli --skill bkt -a codex`. Or copy the skill folder (skills/bkt in avivsinai/bitbucket-cli) into .agents/skills/bkt in your project. Codex loads it when a task matches its description.

Can I use Bkt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add avivsinai/bitbucket-cli --skill bkt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bkt, .gemini/skills/bkt, .github/skills/bkt and .opencode/skills/bkt in your project.

What does Bkt need to run?

Going by SKILL.md and its folder, Bkt needs credentials named BKT_OAUTH_CLIENT_SECRET. Our summary lists: A credential in BKT_OAUTH_CLIENT_SECRET.

Does Bkt access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bkt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bkt use?

Bkt is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bkt use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bkt?

Skills that share tags, products or a category with Bkt: Code Review (yaklang/yakit, 7.8k stars), Create PR (yaklang/yakit, 7.8k stars), Commit Msg (yaklang/yakit, 7.8k stars) and Publish Pull Request for taskctl (taskctl/taskctl, 434 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bkt?

avivsinai (a GitHub user) maintains it in avivsinai/bitbucket-cli, which has 233 GitHub stars. The repository was last updated on October 9, 2026.

Source: avivsinai/bitbucket-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.