| name | bitbucket-api-env |
| description | Use this skill for Bitbucket Cloud work when the user wants REST/API access through injected environment variables and explicitly does not want Bitbucket MCP, mcporter Bitbucket, or connector-backed Bitbucket tools. |
Bitbucket API Env
Use Bitbucket Cloud REST directly. Do not use Bitbucket MCP, mcporter list bitbucket, mcporter call bitbucket.*, or connector-backed Bitbucket tools unless the user explicitly overrides this skill.
Environment
Required repository target:
export BITBUCKET_WORKSPACE=bank-x
export BITBUCKET_REPO_SLUG=mobile-app-workspace
Use one auth mode.
Basic auth with Atlassian email and API token:
export BITBUCKET_USERNAME="$ATLASSIAN_USER_EMAIL"
export BITBUCKET_API_TOKEN="$ATLASSIAN_API_TOKEN"
Bearer auth with a Bitbucket access token:
export BITBUCKET_ACCESS_TOKEN="<token>"
Never paste token values into the conversation or hard-code them into files. Prefer already-exported environment variables. If variables are missing, say exactly which names are missing.
Workflow
- Parse Bitbucket URLs into
workspace, repo_slug, and pull request id when possible. Otherwise use the environment target.
- Use the bundled helper for common read paths:
node /Users/tao.exe/Documents/skill/skills/bitbucket-api-env/scripts/bitbucket-api.mjs pr 123
node /Users/tao.exe/Documents/skill/skills/bitbucket-api-env/scripts/bitbucket-api.mjs comments 123
node /Users/tao.exe/Documents/skill/skills/bitbucket-api-env/scripts/bitbucket-api.mjs activity 123
node /Users/tao.exe/Documents/skill/skills/bitbucket-api-env/scripts/bitbucket-api.mjs diffstat 123
node /Users/tao.exe/Documents/skill/skills/bitbucket-api-env/scripts/bitbucket-api.mjs diff 123 > /private/tmp/bitbucket-pr-123.diff
- For custom endpoints, use
request:
node /Users/tao.exe/Documents/skill/skills/bitbucket-api-env/scripts/bitbucket-api.mjs request GET "/repositories/$BITBUCKET_WORKSPACE/$BITBUCKET_REPO_SLUG/pullrequests?state=OPEN&pagelen=50"
- Keep raw large outputs in
/private/tmp; summarize with exact ids, statuses, branch names, file paths, or line references.
- For Korean internal engineering requests, answer in Korean.
Guardrails
- Default to read-only. Mutating methods require both an explicit user request and
BITBUCKET_API_ALLOW_WRITE=1.
- Report the exact HTTP status and response body excerpt when an API call fails.
- Do not claim that a PR, comment, or file was checked unless the matching API call was actually run.
- Do not fall back to Bitbucket MCP because REST failed. Say the API failure directly, then ask whether to try another route.
Common Endpoints
- Pull request:
GET /repositories/{workspace}/{repo_slug}/pullrequests/{pull_request_id}
- Comments:
GET /repositories/{workspace}/{repo_slug}/pullrequests/{pull_request_id}/comments
- Activity:
GET /repositories/{workspace}/{repo_slug}/pullrequests/{pull_request_id}/activity
- Diff:
GET /repositories/{workspace}/{repo_slug}/pullrequests/{pull_request_id}/diff
- Diffstat:
GET /repositories/{workspace}/{repo_slug}/pullrequests/{pull_request_id}/diffstat
- Commits:
GET /repositories/{workspace}/{repo_slug}/pullrequests/{pull_request_id}/commits
