Agent skill

Bitbucket Cloud

by OpenHands in OpenHands/extensions

Bitbucket Cloud (bitbucket.org) specifics — authenticate with BITBUCKETTOKEN, use the REST API v2, workspace/reposlug repositories, and the createbitbucketpr tool.

MITAuto-check passedBackend & APIs

Install Bitbucket Cloud

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

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

GitHub CLI
$ gh skill install OpenHands/extensions bitbucket-cloud --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-cloud .claude/skills/bitbucket-cloud && 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-cloud
GitHub stars
157
Token cost
~1.1k tokens
SKILL.md length
464 words
Files
5
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Bitbucket Cloud (bitbucket.org) specifics — authenticate with BITBUCKETTOKEN, use the REST API v2, workspace/reposlug repositories, and the createbitbucketpr tool.

  • Tasks that involve REST APIs
  • Calls git, python3 and curl; reaches bitbucket.org and api.bitbucket.org; needs BITBUCKET_TOKEN

What it does

Bitbucket Cloud is an agent skill from OpenHands/extensions. Bitbucket Cloud (bitbucket.org) specifics — authenticate with BITBUCKETTOKEN, use the REST API v2, workspace/reposlug repositories, and the createbitbucketpr tool. Loaded on demand by the bitbucket skill once a Cloud environment is detected.

Its SKILL.md is about 1.1k 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 Backend & APIs, covering REST APIs. It works with Bitbucket and Git. The repository describes itself as: Public registry for OpenHands extensions. The licence is MIT.

When your agent uses it

  • Tasks that involve REST APIs

Example prompts

  • “/bitbucket-cloud”

Requirements

  • Python 3
  • A credential in BITBUCKET_TOKEN

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

    Shell commands in SKILL.md call:

    • git
    • python3
    • curl

    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:

    • bitbucket.org
    • 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

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

Context cost

Bitbucket Cloud loads about 1.1k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 464 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
~1.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 OpenHands/extensions at commit d008b81, republished under its MIT licence (© OpenHands). 464 words, ~1,053 tokens.

Download SKILL.mdSave it as .claude/skills/bitbucket-cloud/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
bitbucket-cloud
description
Bitbucket Cloud (bitbucket.org) specifics — authenticate with BITBUCKET_TOKEN, use the REST API v2, workspace/repo_slug repositories, and the create_bitbucket_pr tool. Loaded on demand by the bitbucket skill once a Cloud environment is detected.

Use authenticated Bitbucket Cloud 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. Use the token and direct REST API instructions below only when those tools are unavailable or when raw API or curl access is explicitly needed.

You are working with Bitbucket Cloud (bitbucket.org). You have access to an environment variable, BITBUCKET_TOKEN, which allows you to interact with the Bitbucket Cloud API.

  • REST API base URL: https://api.bitbucket.org/2.0
  • Repository identifier format: workspace/repo_slug
<IMPORTANT>
You can use `curl` with the `BITBUCKET_TOKEN` to interact with Bitbucket's API.
ALWAYS use the Bitbucket API for operations instead of a web browser.
ALWAYS use the `create_bitbucket_pr` tool to open a pull request
</IMPORTANT>

Only rewrite the Bitbucket remote if a push actually fails with authentication errors and the user has asked you to push. Do not proactively rewrite origin. OpenHands OSS commonly stores BITBUCKET_TOKEN in the same unencoded user:token form used by commands such as curl --user "$BITBUCKET_TOKEN" ..., so keep it in that form unless you truly need to embed it in a Git remote URL.

If you need a non-interactive HTTPS remote URL, split BITBUCKET_TOKEN on the first : and URL-encode each part before calling git remote set-url. This avoids breaking usernames or emails that contain reserved URL characters such as @:

bash
BB_USER="${BITBUCKET_TOKEN%%:*}" && \
BB_PASS="${BITBUCKET_TOKEN#*:}" && \
ENCODED_USER=$(python3 -c 'import sys, urllib.parse; print(urllib.parse.quote(sys.argv[1], safe=""))' "$BB_USER") && \
ENCODED_PASS=$(python3 -c 'import sys, urllib.parse; print(urllib.parse.quote(sys.argv[1], safe=""))' "$BB_PASS") && \
git remote set-url origin "https://${ENCODED_USER}:${ENCODED_PASS}@bitbucket.org/username/repo.git"

PowerShell equivalent for the remote URL encoding:

powershell
$parts = $env:BITBUCKET_TOKEN -split ":", 2
$encodedUser = [Uri]::EscapeDataString($parts[0])
$encodedPass = [Uri]::EscapeDataString($parts[1])
git remote set-url origin "https://${encodedUser}:${encodedPass}@bitbucket.org/username/repo.git"

Atlassian's Bitbucket Cloud docs recommend avoiding long-lived credentials in the remote URL when possible. Their API token examples use either https://{bitbucket_username}:{api_token}@... or https://x-bitbucket-api-token-auth:{api_token}@...; OpenHands users should only construct those URLs on demand, with proper URL encoding.

Here are some instructions for pushing, but ONLY do this if the user asks you to:

Show full SKILL.md (184 more words)Show less
  • NEVER push directly to the main or master branch
  • Git config (username and email) is pre-set. Do not modify.
  • You may already be on a branch starting with openhands-workspace. Create a new branch with a better name before pushing.
  • Use the create_bitbucket_pr tool to create a pull request, if you haven't already
  • Once you've created your own branch or a pull request, continue to update it. Do NOT create a new one unless you are explicitly asked to. Update the PR title and description as necessary, but don't change the branch name.
  • Use the main branch as the base branch, unless the user requests otherwise
  • After opening or updating a pull request, send the user a short message with a link to the pull request.
  • Do NOT mark a pull request as ready to review unless the user explicitly says so
  • Do all of the above in as few steps as possible. E.g. you could push changes with one step by running the following bash commands:
bash
git remote -v && git branch # to find the current org, repo and branch
git checkout -b create-widget && git add . && git commit -m "Create widget" && git push -u origin create-widget

On Windows PowerShell, run those git commands as separate commands if && is not supported by the installed shell.

© 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-cloud 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 Cloud 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 Cloud compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bitbucket Cloud this skillOpenHands/extensions157—~1.1kAutomated safety check: PassMIT
Datajunction APIDataJunction/dj161—~1.8kAutomated safety check: PassMIT
Accessing GitHub Reposoaustegard/claude-skills150—~2.2kAutomated safety check: NotesMIT
Bktavivsinai/bitbucket-cli2311 repos~1kAutomated safety check: PassMIT
GitHub IssuesRedWoodOG/Hermes-Desktop1775 repos~2.3kAutomated safety check: NotesMIT
Qodo PR Resolversbusso/claudeclaw194—~4kAutomated safety check: PassMIT

Similar skills

  • Datajunction API

    DataJunction/dj

    Activate this skill when authoring DataJunction (DJ) nodes via the REST API directly (curl, HTTP clients) — typically for exploration, ad-hoc prototyping, or namespaces that aren't repo-backed.

    161 GitHub stars~1.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Accessing GitHub Repos

    oaustegard/claude-skills

    GitHub repository access in containerized environments using REST API and credential detection.

    150 GitHub stars~2.2k tokensUpdated 5 days ago
    Backend & APIsAuto-check: notes
  • 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
  • GitHub Issues

    RedWoodOG/Hermes-Desktop

    Create, manage, triage, and close GitHub issues. An agent skill from RedWoodOG/Hermes-Desktop.

    177 GitHub starsUsed in 5 repos~2.3k tokens
    DevelopmentAuto-check: notes
  • Qodo PR Resolver

    sbusso/claudeclaw

    Review and resolve PR issues with Qodo - get AI-powered code review issues and fix them interactively (GitHub, GitLab, Bitbucket, Azure DevOps)

    194 GitHub stars~4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • degit Project Scaffolding

    Rich-Harris/degit

    Downloads a repository snapshot or template with degit into an empty folder, from GitHub, GitLab, Bitbucket, Sourcehut or a Gist, optionally at a branch, tag or commit.

    7.9k GitHub stars~534 tokensUpdated 24 days ago
    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 Cloud

What does Bitbucket Cloud do?

Bitbucket Cloud (bitbucket.org) specifics — authenticate with BITBUCKETTOKEN, use the REST API v2, workspace/reposlug repositories, and the createbitbucketpr tool. Bitbucket Cloud is an agent skill from OpenHands/extensions.org) specifics — authenticate with BITBUCKETTOKEN, use the REST API v2, workspace/reposlug repositories, and the createbitbucketpr tool.

When should I use Bitbucket Cloud?

Bitbucket Cloud fits situations like: tasks that involve REST APIs.

How do I install Bitbucket Cloud in Claude Code?

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

How do I install Bitbucket Cloud in Codex?

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

Can I use Bitbucket Cloud 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-cloud -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-cloud, .gemini/skills/bitbucket-cloud, .github/skills/bitbucket-cloud and .opencode/skills/bitbucket-cloud in your project.

What does Bitbucket Cloud need to run?

Going by SKILL.md and its folder, Bitbucket Cloud needs the command-line tools its instructions call (git, python3 and curl) and credentials named BITBUCKET_TOKEN. Our summary lists: Python 3; A credential in BITBUCKET_TOKEN.

Does Bitbucket Cloud access the network?

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

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

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

About 1.1k tokens (SKILL.md is roughly 4.2k 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 Cloud?

Skills that share tags, products or a category with Bitbucket Cloud: Datajunction API (DataJunction/dj, 161 stars), Accessing GitHub Repos (oaustegard/claude-skills, 150 stars), Bkt (avivsinai/bitbucket-cli, 231 stars) and GitHub Issues (RedWoodOG/Hermes-Desktop, 177 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bitbucket Cloud?

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.