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.
- Installs
- 90
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/openhands/extensions --skill bitbucket- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads bitbucket automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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 theBITBUCKET_TOKENenvironment variable. - Bitbucket Data Center (self-hosted Bitbucket Server) — authenticates with the
BITBUCKET_DATA_CENTER_TOKENenvironment 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_TOKENvariable is set (in any letter case) → you are on Bitbucket Data Center. - Otherwise, if a
BITBUCKET_TOKENvariable 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-cloudskill. - Bitbucket Data Center → invoke the
bitbucket-data-centerskill.
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 Cloud | Bitbucket Data Center | |
|---|---|---|
| Token env var | BITBUCKET_TOKEN | BITBUCKET_DATA_CENTER_TOKEN |
| Host | bitbucket.org | self-hosted domain |
| REST API base | https://api.bitbucket.org/2.0 | https://<host>/rest/api/1.0 |
| Repository identifier | workspace/repo_slug | PROJECT/repo_slug (project key) |
| Pull request tool | create_bitbucket_pr | create_bitbucket_data_center_pr |
FAQ
What does the bitbucket skill do?
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 bitbucket?
Run npx skills add https://github.com/openhands/extensions --skill bitbucket in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/bitbucket/ (personal) or .claude/skills/bitbucket/ (project).
Which AI agents can use bitbucket?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is bitbucket safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains bitbucket?
It is published by openhands in openhands/extensions. It has 90 recorded installs.
More from openhands/extensions
ssh
openhands/extensions
Establish and manage SSH connections to remote machines, including key generation, configuration, and file transfers. Use when connecting to remote servers, executing remote commands, or transferring files via SCP.
code-review
openhands/extensions
Review code changes for material correctness, security, compatibility, and maintainability risks, grounded in the current repository and acceptance criteria.
codereview-roasted
openhands/extensions
Brutally honest code review in the style of Linus Torvalds, focusing on data structures, simplicity, and pragmatism. Use when you want critical, no-nonsense feedback that prioritizes engineering fundamentals over style preferences.
security
openhands/extensions
Security best practices for secure coding, authentication, authorization, and data protection. Use when developing features that handle sensitive data, user authentication, or require security review.
docker
openhands/extensions
Run Docker commands within a container environment, including starting the Docker daemon and managing containers. Use when building, running, or managing Docker containers and images.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.