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.