Agent skill

Bitbucket

by OpenHands in OpenHands/extensions

Bitbucket integration hub. An agent skill from OpenHands/extensions.

MITAuto-check passedDevelopment

Install Bitbucket

skills CLI
$ npx skills add OpenHands/extensions --skill bitbucket -a claude-code

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

GitHub CLI
$ gh skill install OpenHands/extensions bitbucket --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/OpenHands/extensions.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bitbucket .claude/skills/bitbucket && 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
bitbucket
GitHub stars
157
Token cost
~765 tokens
SKILL.md length
351 words
Files
5
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Bitbucket integration hub. An agent skill from OpenHands/extensions.

  • Works in 2 steps: Detect which Bitbucket you are on → Load the detailed skill
  • Any Bitbucket repository
  • SKILL.md covers Step 1 — Detect which…, Step 2 — Load the detailed skill and Quick reference (fallback)
  • Reaches api.bitbucket.org; needs BITBUCKET_TOKEN and BITBUCKET_DATA_CENTER_TOKEN

What it does

Bitbucket is an agent skill from OpenHands/extensions. Bitbucket integration hub. Detects whether the repository is on Bitbucket Cloud or Bitbucket Data Center and directs you to the matching detailed skill (bitbucket-cloud or bitbucket-data-center). Use for any Bitbucket repository or pull request task.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `.plugin/plugin.json` and `README.md`).

It sits in Development, covering Pull requests. It works with Bitbucket. The repository describes itself as: Public registry for OpenHands extensions. The licence is MIT.

When your agent uses it

  • Any Bitbucket repository
  • Pull request task

Example prompts

  • “/bitbucket”

Requirements

  • A credential in BITBUCKET_TOKEN
  • A credential in BITBUCKET_DATA_CENTER_TOKEN

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Detect which Bitbucket you are on
  2. Load the detailed skill

What it can do on your machine

Read from SKILL.md and the folder at commit d008b81. 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 (its code samples are bash).

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.bitbucket.org

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

  • Credentials

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

    • BITBUCKET_TOKEN
    • BITBUCKET_DATA_CENTER_TOKEN

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

Context cost

Bitbucket loads about 765 tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 351 words of instructions outside code blocks.

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

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 OpenHands/extensions at commit d008b81, republished under its MIT licence (© OpenHands). 351 words, ~765 tokens.

Download SKILL.mdSave it as .claude/skills/bitbucket/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
bitbucket
description
Bitbucket integration hub. Detects whether the repository is on Bitbucket Cloud or Bitbucket Data Center and directs you to the matching detailed skill (bitbucket-cloud or bitbucket-data-center). Use for any Bitbucket repository or pull request task.
triggers
bitbucket

Use authenticated Bitbucket MCP tools first when they are available in the agent's environment. Detect this by tool availability, without depending on a particular MCP server name. Still identify Cloud versus Data Center and load the matching detailed skill. Use the token and direct API instructions only when Bitbucket MCP tools are unavailable or when raw API or curl access is explicitly needed.

You are working with Bitbucket, which ships as two distinct products that behave differently:

  • Bitbucket Cloud (bitbucket.org) — authenticates with the BITBUCKET_TOKEN environment variable.
  • Bitbucket Data Center (self-hosted Bitbucket Server) — authenticates with the BITBUCKET_DATA_CENTER_TOKEN environment variable.

They use different REST APIs, repository identifiers, git remote URL formats, and pull request tools, so you must first determine which one you are on, then load the matching detailed skill for full instructions.

Step 1 — Detect which Bitbucket you are on

First use the repository host or available Bitbucket MCP tool context to identify the product. For the token fallback, check which token environment variable is present. Environment variable names are case-sensitive, so look for it case-insensitively:

bash
env | grep -i 'bitbucket' || echo "no bitbucket token found"
  • If a BITBUCKET_DATA_CENTER_TOKEN variable is set (in any letter case) → you are on Bitbucket Data Center.
  • Otherwise, if a BITBUCKET_TOKEN variable is set → you are on Bitbucket Cloud.
  • If neither is set, ask the user how they authenticate to Bitbucket before proceeding.

When you reference the token later, use the exact variable name (and letter case) that actually exists in the environment.

Show full SKILL.md (113 more words)Show less

Step 2 — Load the detailed skill

Once you know the environment, use the invoke_skill tool to load the matching skill for full instructions on API calls, authenticated git remotes, and opening pull requests:

  • Bitbucket Cloud → invoke the bitbucket-cloud skill.
  • Bitbucket Data Center → invoke the bitbucket-data-center skill.

Quick reference (fallback)

If you are unable to load the detailed skill, these are the essentials. Always use the Bitbucket API (not a web browser) and always use the listed PR tool to open a pull request.

Bitbucket CloudBitbucket Data Center
Token env varBITBUCKET_TOKENBITBUCKET_DATA_CENTER_TOKEN
Hostbitbucket.orgself-hosted domain
REST API basehttps://api.bitbucket.org/2.0https://<host>/rest/api/1.0
Repository identifierworkspace/repo_slugPROJECT/repo_slug (project key)
Pull request toolcreate_bitbucket_prcreate_bitbucket_data_center_pr

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

Files

SKILL.md and 4 other files in skills/bitbucket of OpenHands/extensions.

  • SKILL.md
  • .claude-plugin
  • .codex-plugin
  • .plugin/plugin.json
  • README.md

Open the folder on GitHubat commit d008b81

Compare with similar skills

Bitbucket 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.

Bitbucket compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bitbucket this skillOpenHands/extensions157—~765Automated safety check: PassMIT
Bktavivsinai/bitbucket-cli2311 repos~1kAutomated safety check: PassMIT
Rota Update Importoracle/graalpython1.7k—~475Automated safety check: PassCustom licence
Bitbucket PR ReviewGGGODLIN/claude-pr-review114—~4.8kAutomated safety check: PassMIT
Bitbucket PR MutationGGGODLIN/claude-pr-review114—~3.3kAutomated safety check: PassMIT
Graalpython Bitbucket PRoracle/graalpython1.7k—~1.3kAutomated safety check: PassCustom licence

Similar skills

  • Bkt

    avivsinai/bitbucket-cli

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

    231 GitHub starsUsed in 1 repo~1k tokens
    DevelopmentAuto-check passed
  • Rota Update Import

    oracle/graalpython

    Official

    Run the GraalPy ROTA import update workflow. An agent skill from oracle/graalpython.

    1.7k GitHub stars~475 tokensUpdated today
    DevelopmentAuto-check passed
  • Bitbucket PR Review

    GGGODLIN/claude-pr-review

    A skill your agent uses when the user asks to inspect an existing Bitbucket finding, comment, author reply, diff location, or PR evidence without running a full code review.

    114 GitHub stars~4.8k tokensUpdated 19 days ago
    DevelopmentAuto-check passed
  • Bitbucket PR Mutation

    GGGODLIN/claude-pr-review

    A skill your agent uses when a user asks Claude Code to create a Bitbucket pull request or perform any Bitbucket PR write, including description, title, state, review-decision or comment changes…

    114 GitHub stars~3.3k tokensUpdated 19 days ago
    DevelopmentAuto-check passed
  • Graalpython Bitbucket PR

    oracle/graalpython

    Official

    Create or continue a GraalPython Bitbucket pull request and drive it through Graal Bot tasks, gate start, gate monitoring, failure investigation, fixes, pushes, and gate reruns.

    1.7k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Generate Pull Request

    jrkerns/pylinac

    Generate a draft Bitbucket pull request with proper formatting

    202 GitHub stars~304 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from OpenHands/extensions

All 78 skills in this repo
  • Agent Readiness Report

    OpenHands/extensions

    Evaluate how well a codebase supports autonomous AI-assisted development.

    157 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Discord

    OpenHands/extensions

    Build and automate Discord integrations (bots, webhooks, slash commands, and REST API workflows).

    157 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • GitHub

    OpenHands/extensions

    Interact with GitHub repositories, pull requests, issues, and workflows using the GITHUBTOKEN environment variable and GitHub CLI.

    157 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • GitHub Issue To PR

    OpenHands/extensions

    Create an automation that implements GitHub issues when a configurable trigger label is applied.

    157 GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • GitHub Repo Monitor

    OpenHands/extensions

    This skill should be used when the user asks to "monitor a GitHub repository", "watch GitHub for issues or PRs", "respond to @OpenHands mentions on GitHub", "set up an OpenHands GitHub integration"…

    157 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • GitLab Issue To Mr

    OpenHands/extensions

    Create an automation that implements GitLab issues when a configurable trigger label is applied.

    157 GitHub stars~4.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Bitbucket

What does Bitbucket do?

Bitbucket integration hub. An agent skill from OpenHands/extensions. Bitbucket is an agent skill from OpenHands/extensions. Bitbucket integration hub.

When should I use Bitbucket?

Bitbucket fits situations like: any Bitbucket repository; pull request task.

How do I install Bitbucket in Claude Code?

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

How do I install Bitbucket in Codex?

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

Can I use Bitbucket 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 OpenHands/extensions --skill bitbucket -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bitbucket, .gemini/skills/bitbucket, .github/skills/bitbucket and .opencode/skills/bitbucket in your project.

What does Bitbucket need to run?

Going by SKILL.md and its folder, Bitbucket needs credentials named BITBUCKET_TOKEN and BITBUCKET_DATA_CENTER_TOKEN. Our summary lists: A credential in BITBUCKET_TOKEN; A credential in BITBUCKET_DATA_CENTER_TOKEN.

Does Bitbucket access the network?

SKILL.md names 1 domain. In commands or code: api.bitbucket.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Bitbucket 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 Bitbucket use?

Bitbucket 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 Bitbucket use?

About 765 tokens (SKILL.md is roughly 3.1k 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 Bitbucket?

Skills that share tags, products or a category with Bitbucket: Bkt (avivsinai/bitbucket-cli, 231 stars), Rota Update Import (oracle/graalpython, 1.7k stars), Bitbucket PR Review (GGGODLIN/claude-pr-review, 114 stars) and Bitbucket PR Mutation (GGGODLIN/claude-pr-review, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bitbucket?

OpenHands (a GitHub organization) maintains it in OpenHands/extensions, which has 157 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 6, 2026.

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