skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
openhands/extensions97 installs

bitbucket

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.

How do I install this agent skill?

npx skills add https://github.com/openhands/extensions --skill bitbucket
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a routing hub for Bitbucket integrations. It identifies the target environment (Bitbucket Cloud or Bitbucket Data Center) by checking for specific environment variables and then invokes the corresponding specialized skill. No security issues were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    2/2 files flagged

What does this agent skill do?

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:

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.

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

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/openhands/extensions/bitbucket">View bitbucket on skillZs</a>