jira
Use when interacting with Jira
When & Why to Use This Skill
The Jira CLI Skill enables Claude to interact directly with Atlassian Jira to manage stories, tasks, and sprints efficiently. By utilizing the Atlassian CLI (acli), this skill allows for seamless ticket manipulation, status transitions, and advanced JQL (Jira Query Language) searches. It is designed to streamline project management workflows by providing structured data output and automating routine issue-tracking tasks within the AI conversation.
Use Cases
- Ticket Lifecycle Management: Quickly view, assign, and update Jira tickets or stories, including adding comments and changing assignees without leaving the chat.
- Sprint Monitoring and Reporting: Execute complex JQL queries to list incomplete tasks, filter by specific statuses (e.g., 'To Do', 'In Progress'), and track team velocity.
- Workflow Automation: Transition issues through various development stages such as 'Ready for Code Review' or 'Accepted' to keep project boards up to date in real-time.
- Advanced Issue Searching: Use structured JQL filters and CSV formatting to extract specific work item data for status updates or project audits.
| name | jira |
|---|---|
| description | Use when interacting with Jira stories and sprints |
| - Bash(acli jira workitem view | *) |
| - Bash(acli jira workitem search | *) |
| - Bash(acli jira auth | *) |
| - Bash(acli jira --help | *) |
Jira CLI Skill
Uses acli (Atlassian CLI) for Jira operations. Authentication: acli jira auth login --web
The common tasks below are EXAMPLES of things you may be asked to do. You DO NOT need to follow their formats exactly
Common Tasks
Get a ticket:
acli jira workitem view DO-123
Update a ticket:
acli jira workitem edit DO-123 --assignee username --comment "text"
List tickets assigned to me:
acli jira workitem search --jql "assignee = currentUser() AND status NOT IN ('Accepted', 'Closed', 'In Production', 'Not Doing')" --paginate --csv
Other useful commands:
acli jira workitem search --jql "JQL_QUERY" --csv- Search with JQLacli jira workitem transition DO-123 --status "In Progress" --csv- Change statusacli jira workitem assign DO-123 --assignee username --csv- Assign ticket
Common Story Statuses:
- To Do
- In Progress
- Ready for Code Review
- Ready for Acceptance
- Accepted
- In Production
- Closed
- Icebox
- Not Doing
Filtering Guidelines:
- DEFAULT BEHAVIOR: Unless explicitly requested otherwise, ONLY show stories that are NOT completed
- Completed statuses to exclude: Accepted, Closed, In Production, Not Doing
- Use status-based filtering:
status NOT IN ('Accepted', 'Closed', 'In Production', 'Not Doing') - For specific statuses, use:
status = "In Progress"orstatus IN ("To Do", "In Progress")
IMPORTANT: ALWAYS use --csv flag for all commands to get structured output.
Documentation
Official docs: https://developer.atlassian.com/cloud/acli/
If you encounter errors or need to understand command options, use acli jira workitem --help or acli jira workitem <command> --help.