atlassian-api-guidelines

Implement Atlassian Cloud API workflows for Jira and Bitbucket with REST calls.

1|Updated Nov 22, 2024
One-click install
npx skills add https://github.com/rjcnd105/hj-dotfiles --skill atlassian-api-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atlassian-api-guidelines
Source: https://github.com/rjcnd105/hj-dotfiles/tree/main/files/workspace/.config/opencode/skill/atlassian-api-guidelines
Command: npx skills add https://github.com/rjcnd105/hj-dotfiles --skill atlassian-api-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Atlassian API integration patterns are often inconsistent across Jira and Bitbucket. This Skill provides standardized guidance for server-side filtering, pagination, authentication, and error handling when working with Atlassian Cloud APIs.

Core Features & Use Cases

  • Jira: search, create, update, and transition issues using JQL and REST endpoints with proper filtering.
  • Bitbucket: manage pull requests and repository data using q parameters, pagination, and standard auth flows.
  • Use Case: A developer automates Jira issue triage and Bitbucket PR reviews using consistent, documented patterns.

Quick Start

Reference the Jira and Bitbucket Swagger specs, apply server-side filtering, and implement common REST API calls with proper pagination and authentication.

Frequently Asked Questions about atlassian-api-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I filter Jira and Bitbucket API results on the server side?

To filter Atlassian Cloud API results on the server side, use JQL for Jira issue searches and the q parameter for Bitbucket repository data retrieval. This approach reduces payload size and improves automation efficiency.

What is the best way to authenticate Atlassian Cloud REST API calls for Jira and Bitbucket?

Authenticating Atlassian Cloud REST API calls for Jira and Bitbucket requires implementing standard authentication flows. Using standardized patterns ensures secure access for automating issue triage and pull request reviews.

How do I handle pagination when fetching large datasets from Jira APIs?

Handling pagination when fetching large datasets from Jira APIs requires implementing standard pagination patterns across your REST calls. This ensures complete data retrieval for issue management workflows without missing records.

Do I need external tooling to implement Bitbucket pull request operations?

No external tooling is required to implement Bitbucket pull request operations beyond standard REST calls and configuration. You can manage repository data and PR reviews using ready-to-use guidance and Swagger-based references.

Why does my Atlassian API integration pattern fail across different Jira and Bitbucket endpoints?

Atlassian API integration patterns often fail across Jira and Bitbucket due to inconsistent implementation. Standardizing error handling, authentication, and server-side filtering ensures consistent behavior across issue management and PR operations.