К основному содержанию
скилл CX Codex

bitbucket-automation — скилл для Claude Code: Bitbucket через MCP

Скилл bitbucket-automation для Claude Code и Cursor управляет репозиториями, пул-реквестами, ветками и задачами Bitbucket через MCP-сервер Rube от Composio. Операции запускаются из чата агента.

MIT ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add davepoon/buildwithclaude
/plugin install all-skills@buildwithclaude
Открыть на GitHub

Что делает bitbucket-automation

Скилл описывает рабочие цепочки для типовых действий в Bitbucket: создать пул-реквест, посмотреть дифф, завести репозиторий, разобрать задачи, ответвить новую ветку от коммита. Для каждого сценария прописан порядок вызовов инструментов и параметры — например, workspace, repo_slug, source_branch, destination_branch.

Сам скилл ничего не делает без подключённого MCP-сервера Rube. В конфигурацию клиента добавляют https://rube.app/mcp, ключи API не нужны. Дальше вызывают RUBE_MANAGE_CONNECTIONS с тулкитом bitbucket и проходят OAuth по выданной ссылке. Пока соединение не в статусе ACTIVE, рабочие цепочки не запустятся.

Внутри разобраны ловушки API, на которых легко споткнуться. Ревьюеров в пул-реквест передают массивом объектов с полем uuid в фигурных скобках, а не именами. Флаг is_private у нового репозитория по умолчанию true. Для CREATE_BRANCH нужен полный хеш коммита в target_hash, имя ветки не подойдёт. Удаление репозитория и задачи необратимо.

Какие задачи решает

  • создать пул-реквест с нужными ревьюерами и исходной веткой
  • посмотреть дифф и статистику изменений перед ревью
  • завести репозиторий с нужной видимостью и проектом
  • создать ветку от конкретного коммита
  • обновить статус и приоритет задачи в трекере

Примеры запросов агенту

  • Создай пул-реквест из feature/login в main в репозитории api рабочего пространства team, добавь ревьюера по uuid
  • Покажи дифф пул-реквеста 42, обрежь до 50000 символов
  • Создай ветку feature/new-login от коммита a1b2c3 и заведи задачу с приоритетом major

Как установить bitbucket-automation

1Через маркетплейс плагинов

/plugin marketplace add davepoon/buildwithclaude
/plugin install all-skills@buildwithclaude

Команда ставит плагин all-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill bitbucket-automation -a claude-code

3Вручную: положить файлы

~/.claude/skills/bitbucket-automation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bitbucket-automation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о bitbucket-automation

Как установить bitbucket-automation в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add davepoon/buildwithclaude, затем поставьте плагин: /plugin install all-skills@buildwithclaude. Альтернатива — npx skills add davepoon/buildwithclaude --skill bitbucket-automation -a claude-code.

Что делает bitbucket-automation?

Описывает, как через тулкит Bitbucket в Composio работать с репозиториями, пул-реквестами, ветками и задачами: какие инструменты вызывать и в каком порядке.

Что нужно для работы скилла?

Подключённый MCP-сервер Rube по адресу https://rube.app/mcp и активное соединение с Bitbucket через RUBE_MANAGE_CONNECTIONS. Перед работой скилл советует сначала вызывать RUBE_SEARCH_TOOLS, чтобы получить актуальные схемы.

Исходный текст

SKILL.md · MIT
---
name: bitbucket-automation
description: Automate Bitbucket repositories, pull requests, branches, issues, and workspace management via Rube MCP (Composio). Always search tools first for current schemas.
requires:
  mcp: [rube]
category: devops
---

# Bitbucket Automation via Rube MCP

Automate Bitbucket operations including repository management, pull request workflows, branch operations, issue tracking, and workspace administration through Composio's Bitbucket toolkit.

**Toolkit docs**: [composio.dev/toolkits/bitbucket](https://composio.dev/toolkits/bitbucket)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Bitbucket connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `bitbucket`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `bitbucket`
3. If connection is not ACTIVE, follow the returned auth link to complete Bitbucket OAuth
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. Manage Pull Requests

**When to use**: User wants to create, review, or inspect pull requests

**Tool sequence**:
1. `BITBUCKET_LIST_WORKSPACES` - Discover accessible workspaces [Prerequisite]
2. `BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE` - Find the target repository [Prerequisite]
3. `BITBUCKET_LIST_BRANCHES` - Verify source and destination branches exist [Prerequisite]
4. `BITBUCKET_CREATE_PULL_REQUEST` - Create a new PR with title, source branch, and optional reviewers [Required]
5. `BITBUCKET_LIST_PULL_REQUESTS` - List PRs filtered by state (OPEN, MERGED, DECLINED) [Optional]
6. `BITBUCKET_GET_PULL_REQUEST` - Get full details of a specific PR by ID [Optional]
7. `BITBUCKET_GET_PULL_REQUEST_DIFF` - Fetch unified diff for code review [Optional]
8. `BITBUCKET_GET_PULL_REQUEST_DIFFSTAT` - Get changed files with lines added/removed [Optional]

**Key parameters**:
- `workspace`: Workspace slug or UUID (required for all operations)
- `repo_slug`: URL-friendly repository name
- `source_branch`: Branch with changes to merge
- `destination_branch`: Target branch (defaults to repo main branch if omitted)
- `reviewers`: List of objects with `uuid` field for reviewer assignment
- `state`: Filter for LIST_PULL_REQUESTS - `OPEN`, `MERGED`, or `DECLINED`
- `max_chars`: Truncation limit for GET_PULL_REQUEST_DIFF to handle large diffs

**Pitfalls**:
- `reviewers` expects an array of objects with `uuid` key, NOT usernames: `[{"uuid": "{...}"}]`
- UUID format must include curly braces: `{123e4567-e89b-12d3-a456-426614174000}`
- `destination_branch` defaults to the repo's main branch if omitted, which may not be `main`
- `pull_request_id` is an integer for GET/DIFF operations but comes back as part of PR listing
- Large diffs can overwhelm context; always set `max_chars` (e.g., 50000) on GET_PULL_REQUEST_DIFF

### 2. Manage Repositories and Workspaces

**When to use**: User wants to list, create, or delete repositories or explore workspaces

**Tool sequence**:
1. `BITBUCKET_LIST_WORKSPACES` - List all accessible workspaces [Required]
2. `BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE` - List repos with optional BBQL filtering [Required]
3. `BITBUCKET_CREATE_REPOSITORY` - Create a new repo with language, privacy, and project settings [Optional]
4. `BITBUCKET_DELETE_REPOSITORY` - Permanently delete a repository (irreversible) [Optional]
5. `BITBUCKET_LIST_WORKSPACE_MEMBERS` - List members for reviewer assignment or access checks [Optional]

**Key parameters**:
- `workspace`: Workspace slug (find via LIST_WORKSPACES)
- `repo_slug`: URL-friendly name for create/delete
- `q`: BBQL query filter (e.g., `name~"api"`, `project.key="PROJ"`, `is_private=true`)
- `role`: Filter repos by user role: `member`, `contributor`, `admin`, `owner`
- `sort`: Sort field with optional `-` prefix for descending (e.g., `-updated_on`)
- `is_private`: Boolean for repository visibility (defaults to `true`)
- `project_key`: Bitbucket project key; omit to use workspace's oldest project

**Pitfalls**:
- `BITBUCKET_DELETE_REPOSITORY` is **irreversible** and does not affect forks
- BBQL string values MUST be enclosed in double quotes: `name~"my-repo"` not `name~my-repo`
- `repository` is NOT a valid BBQL field; use `name` instead
- Default pagination is 10 results; set `pagelen` explicitly for complete listings
- `CREATE_REPOSITORY` defaults to private; set `is_private: false` for public repos

### 3. Manage Issues

**When to use**: User wants to create, update, list, or comment on repository issues

**Tool sequence**:
1. `BITBUCKET_LIST_ISSUES` - List issues with optional filters for state, priority, kind, assignee [Required]
2. `BITBUCKET_CREATE_ISSUE` - Create a new issue with title, content, priority, and kind [Required]
3. `BITBUCKET_UPDATE_ISSUE` - Modify issue attributes (state, priority, assignee, etc.) [Optional]
4. `BITBUCKET_CREATE_ISSUE_COMMENT` - Add a markdown comment to an existing issue [Optional]
5. `BITBUCKET_DELETE_ISSUE` - Permanently delete an issue [Optional]

**Key parameters**:
- `issue_id`: String identifier for the issue
- `title`, `content`: Required for creation
- `kind`: `bug`, `enhancement`, `proposal`, or `task`
- `priority`: `trivial`, `minor`, `major`, `critical`, or `blocker`
- `state`: `new`, `open`, `resolved`, `on hold`, `invalid`, `duplicate`, `wontfix`, `closed`
- `assignee`: Bitbucket username for CREATE; `assignee_account_id` (UUID) for UPDATE
- `due_on`: ISO 8601 format date string

**Pitfalls**:
- Issue tracker must be enabled on the repository (`has_issues: true`) or API calls will fail
- `CREATE_ISSUE` uses `assignee` (username string), but `UPDATE_ISSUE` uses `assignee_account_id` (UUID) -- they are different fields
- `DELETE_ISSUE` is permanent with no undo
- `state` values include spaces: `"on hold"` not `"on_hold"`
- Filtering by `assignee` in LIST_ISSUES uses account ID, not username; use `"null"` string for unassigned

### 4. Manage Branches

**When to use**: User wants to create branches or explore branch structure

**Tool sequence**:
1. `BITBUCKET_LIST_BRANCHES` - List branches with optional BBQL filter and sorting [Required]
2. `BITBUCKET_CREATE_BRANCH` - Create a new branch from a specific commit hash [Required]

**Key parameters**:
- `name`: Branch name without `refs/heads/` prefix (e.g., `feature/new-login`)
- `target_hash`: Full SHA1 commit hash to branch from (must exist in repo)
- `q`: BBQL filter (e.g., `name~"feature/"`, `name="main"`)
- `sort`: Sort by `name` or `-target.date` (descending commit date)
- `pagelen`: 1-100 results per page (default is 10)

**Pitfalls**:
- `CREATE_BRANCH` requires a full commit hash, NOT a branch name as `target_hash`
- Do NOT include `refs/heads/` prefix in branch names
- Branch names must follow Bitbucket naming conventions (alphanumeric, `/`, `.`, `_`, `-`)
- BBQL string values need double quotes: `name~"feature/"` not `name~feature/`

### 5. Review Pull Requests with Comments

**When to use**: User wants to add review comments to pull requests, including inline code comments

**Tool sequence**:
1. `BITBUCKET_GET_PULL_REQUEST` - Get PR details and verify it exists [Prerequisite]
2. `BITBUCKET_GET_PULL_REQUEST_DIFF` - Review the actual code changes [Prerequisite]
3. `BITBUCKET_GET_PULL_REQUEST_DIFFSTAT` - Get list of changed files [Optional]
4. `BITBUCKET_CREATE_PULL_REQUEST_COMMENT` - Post review comments [Required]

**Key parameters**:
- `pull_request_id`: String ID of the PR
- `content_raw`: Markdown-formatted comment text
- `content_markup`: Defaults to `markdown`; also supports `plaintext`
- `inline`: Object with `path`, `from`, `to` for inline code comments
- `parent_comment_id`: Integer ID for threaded replies to existing comments

**Pitfalls**:
- `pull_request_id` is a string in CREATE_PULL_REQUEST_COMMENT but an integer in GET_PULL_REQUEST
- Inline comments require `inline.path` at minimum; `from`/`to` are optional line numbers
- `parent_comment_id` creates a threaded reply; omit for top-level comments
- Line numbers in inline comments reference the diff, not the source file

## Common Patterns

### ID Resolution
Always resolve human-readable names to IDs before operations:
- **Workspace**: `BITBUCKET_LIST_WORKSPACES` to get workspace slugs
- **Repository**: `BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE` with `q` filter to find repo slugs
- **Branch**: `BITBUCKET_LIST_BRANCHES` to verify branch existence before PR creation
- **Members**: `BITBUCKET_LIST_WORKSPACE_MEMBERS` to get UUIDs for reviewer assignment

### Pagination
Bitbucket uses page-based pagination (not cursor-based):
- Use `page` (starts at 1) and `pagelen` (items per page) parameters
- Default page size is typically 10; set `pagelen` explicitly (max 50 for PRs, 100 for others)
- Check response for `next` URL or total count to determine if more pages exist
- Always iterate through all pages for complete results

### BBQL Filtering
Bitbucket Query Language is available on list endpoints:
- String values MUST use double quotes: `name~"pattern"`
- Operators: `=` (exact), `~` (contains), `!=` (not equal), `>`, `>=`, `<`, `<=`
- Combine with `AND` / `OR`: `name~"api" AND is_private=true`

## Known Pitfalls

### ID Formats
- Workspace: slug string (e.g., `my-workspace`) or UUID in braces (`{uuid}`)
- Reviewer UUIDs must include curly braces: `{123e4567-e89b-12d3-a456-426614174000}`
- Issue IDs are strings; PR IDs are integers in some tools, strings in others
- Commit hashes must be full SHA1 (40 characters)

### Parameter Quirks
- `assignee` vs `assignee_account_id`: CREATE_ISSUE uses username, UPDATE_ISSUE uses UUID
- `state` values for issues include spaces: `"on hold"`, not `"on_hold"`
- `destination_branch` omission defaults to repo main branch, not `main` literally
- BBQL `repository` is not a valid field -- use `name`

### Rate Limits
- Bitbucket Cloud API has rate limits; large batch operations should include delays
- Paginated requests count against rate limits; minimize unnecessary page fetches

### Destructive Operations
- `BITBUCKET_DELETE_REPOSITORY` is irreversible and does not remove forks
- `BITBUCKET_DELETE_ISSUE` is permanent with no recovery option
- Always confirm with the user before executing delete operations

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| List workspaces | `BITBUCKET_LIST_WORKSPACES` | `q`, `sort` |
| List repos | `BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE` | `workspace`, `q`, `role` |
| Create repo | `BITBUCKET_CREATE_REPOSITORY` | `workspace`, `repo_slug`, `is_private` |
| Delete repo | `BITBUCKET_DELETE_REPOSITORY` | `workspace`, `repo_slug` |
| List branches | `BITBUCKET_LIST_BRANCHES` | `workspace`, `repo_slug`, `q` |
| Create branch | `BITBUCKET_CREATE_BRANCH` | `workspace`, `repo_slug`, `name`, `target_hash` |
| List PRs | `BITBUCKET_LIST_PULL_REQUESTS` | `workspace`, `repo_slug`, `state` |
| Create PR | `BITBUCKET_CREATE_PULL_REQUEST` | `workspace`, `repo_slug`, `title`, `source_branch` |
| Get PR details | `BITBUCKET_GET_PULL_REQUEST` | `workspace`, `repo_slug`, `pull_request_id` |
| Get PR diff | `BITBUCKET_GET_PULL_REQUEST_DIFF` | `workspace`, `repo_slug`, `pull_request_id`, `max_chars` |
| Get PR diffstat | `BITBUCKET_GET_PULL_REQUEST_DIFFSTAT` | `workspace`, `repo_slug`, `pull_request_id` |
| Comment on PR | `BITBUCKET_CREATE_PULL_REQUEST_COMMENT` | `workspace`, `repo_slug`, `pull_request_id`, `content_raw` |
| List issues | `BITBUCKET_LIST_ISSUES` | `workspace`, `repo_slug`, `state`, `priority` |
| Create issue | `BITBUCKET_CREATE_ISSUE` | `workspace`, `repo_slug`, `title`, `content` |
| Update issue | `BITBUCKET_UPDATE_ISSUE` | `workspace`, `repo_slug`, `issue_id` |
| Comment on issue | `BITBUCKET_CREATE_ISSUE_COMMENT` | `workspace`, `repo_slug`, `issue_id`, `content` |
| Delete issue | `BITBUCKET_DELETE_ISSUE` | `workspace`, `repo_slug`, `issue_id` |
| List members | `BITBUCKET_LIST_WORKSPACE_MEMBERS` | `workspace` |

---
*Powered by [Composio](https://composio.dev)*

© BuildWithClaude Community · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
bitbucket-workflow Mindrally Скилл bitbucket-workflow задаёт агенту правила работы с Bitbucket: оформление пул-реквестов, конфигурация Pipelines, связка с Jira и ветвление по Gitflow. CX Codex +1 808установок Bitbucket MCP FabianSchurig Даёт агенту доступ к репозиториям, веткам и pull request'ам в Bitbucket Cloud. Помогает работать с Bitbucket через ИИ-ассистента. CX Codex +1 ★ 7звёзд репо github-automation davila7 Скилл github-automation для Claude, который проводит операции GitHub через Rube MCP: issues, пул-реквесты, ветки, поиск по коду и CI/CD. CX Codex +1 63установок bkt avivsinai Скилл учит агента работать с Bitbucket Cloud и Data Center через утилиту bkt. Помогает просматривать пуллреквесты, ветки, пайплайны и безопасно выполнять слияния. CX Codex +1 2 100установок mcp Aviv Sinai Правило описывает MCP-сервер bkt mcp serve: чтение из Bitbucket, один закреплённый контекст и жёсткие лимиты на размер ответов. CX Codex +1 ★ 1 596звёзд репо pr Aviv Sinai Справочник по bkt pr для агента: создать, посмотреть, одобрить и смержить pull request в Bitbucket Data Center или Cloud. CX Codex +1 ★ 1 596звёзд репо

Из того же набора235

Весь набор →
clickup-automation Скилл clickup-automation для Claude Code и Cursor, который автоматизирует управление проектами в ClickUp через Rube MCP: создание и обновление задач, навигация по рабочему пространству, комментарии и управление командой. CX Codex +1 ★ 3 785звёзд репо issue-triage Команда issue-triage разбирает входящие GitHub-issues: ставит категорию, приоритет и команду, ищет дубли и заводит задачу в Linear. CX Codex +1 ★ 3 785звёзд репо todoist-automation Скилл todoist-automation для управления задачами, проектами и секциями Todoist через Rube MCP без ручного переключения в интерфейс сервиса. CX Codex +1 ★ 3 785звёзд репо monday-automation Скилл monday-automation управляет досками Monday.com и их содержимым через Rube MCP. Пригодится, чтобы создавать задачи, менять значения столбцов и распределять элементы по группам. CX Codex +1 ★ 3 785звёзд репо pipedrive-automation Скилл pipedrive-automation для Claude Code и Cursor, который управляет сделками, контактами, организациями, активностями и заметками в Pipedrive через Rube MCP (Composio). CX Codex +1 ★ 3 785звёзд репо gsd-intel-updater Субагент gsd-intel-updater для Claude Code анализирует файлы проекта и обновляет структурированные сведения в .planning/intel/, чтобы другие агенты находили факты о коде без повторного изучения всей кодовой базы. CX Codex ★ 3 785звёзд репо box-automation Скилл box-automation для автоматизации операций с облачным хранилищем Box: загрузка и скачивание файлов, поиск, управление папками, совместный доступ и метаданные. Работает через Rube MCP и Composio. CX Codex +1 ★ 3 785звёзд репо dropbox-automation Скилл dropbox-automation для Claude Code и Cursor, который автоматизирует операции с Dropbox через Rube MCP (Composio): загрузка и скачивание файлов, поиск, управление папками, создание ссылок. CX Codex +1 ★ 3 785звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой