Skip to main content

Atlassian CLI

Path: .cursor/skills/acli/SKILL.md

Category: DevOps

Triggers: Jira, issues, sprints, tickets, story points

What It Does​

Teaches the agent to use the Atlassian CLI (acli) for Jira operations across multiple pods/boards: creating issues with Gherkin acceptance criteria, managing sprints, transitioning work items, searching tickets, and setting story points via the REST API.

Key Commands​

CommandPurpose
acli jira createIssueCreate a Jira issue with summary, description, type
acli jira getIssueFetch issue details
acli jira transitionIssueMove issue through workflow states
acli jira addCommentAdd a comment to an issue

Issue Creation Conventions​

Acceptance Criteria​

Issues use Gherkin format for acceptance criteria:

Given [precondition]
When [action]
Then [expected result]

QA Test Requirements​

Each issue includes explicit QA test requirements alongside the acceptance criteria.

Estimation​

Story points use the Fibonacci scale and are set via the Jira REST API (the CLI doesn't support custom fields directly).

REST API Fallback​

For operations not supported by the CLI (like setting story points or writing ADF-formatted descriptions), the skill falls back to direct Jira REST API calls via curl.