Bitbucket Pull Request Skill

1. Purpose

Use this skill to fetch and review comments from Bitbucket pull requests. It retrieves all comments from a PR or fetches a specific comment by ID for detailed analysis.

2. Usage Scenarios

Run before:

• Reviewing PR comments to address feedback.
• Analyzing discussion patterns in a pull request.
• Extracting specific comment details for documentation.
• Understanding inline vs. general comments on a PR.

3. Helper Scripts

Arguments

• Required: PR ID (pull request identifier)
• For get mode: Comment ID (specific comment identifier)
• Modes:
  • list - Get all comments for a PR (default)
  • get - Get one specific comment by ID

4. Examples

List All Comments

bitbucket_pr_comments.sh list 12345

Returns all comments with ID, content, and inline status for PR #12345.

Get Specific Comment

bitbucket_pr_comments.sh get 12345 67890

Returns detailed content for comment ID 67890 on PR #12345.

Pipe to jq for Custom Filtering

bitbucket_pr_comments.sh list 12345 | jq 'map(select(.inline == true))'

Filter to show only inline comments.

5. Output Format

List Mode (JSON array)

[
  {
    "id": "67890",
    "content": "Please review this change.",
    "inline": false
  },
  {
    "id": "67891",
    "content": "Consider using async/await here.",
    "inline": true
  }
]

Get Mode (Raw content)

Returns the raw markdown content of the specified comment.

6. Exit Codes

7. Environment Variables

8. Troubleshooting

9. Prerequisites

• Bitbucket CLI (bb) installed and authenticated
• jq for JSON parsing
• Access to the target Bitbucket repository