jira

Search, create, update, and transition Jira issues via REST API and acli.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill jira-pgoell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/atlassian/skills/jira
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill jira-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing Jira work items manually through the web UI interrupts development flow. This Skill lets you search issues, create tickets, add comments, transition workflows, and inspect sprints directly from natural language requests using the Jira REST API or the acli CLI. ## Core Features & Use Cases - Issue Operations: Search with JQL, view, create, edit, comment on, assign, link, and transition issues using curl-first commands with acli fallbacks. - Sprint and Bulk Management: List board sprints, view sprint work items, and run bulk transitions across all issues matching a JQL query. - Structured Ticket Creation: Apply a built-in ticket template with Context, Deliverable, Scope, Stakeholders, Timebox, and Acceptance Criteria sections, plus ADF formatting and JQL recipe references. - Use Case: Ask "what am I working on?" to run a JQL search for your in-progress issues, then say "move PROJ-123 to done and comment that the fix is deployed" to transition and update the ticket in one flow. ## Quick Start Ask the assistant to show your open Jira issues or create a new ticket in your project using natural language.

Frequently Asked Questions about jira

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

FAQPage Schema
How do I search Jira issues with JQL from the command line?

Use curl to POST a JQL query to the /rest/api/3/search/jql endpoint, or run acli jira workitem search with the --jql flag. The Skill includes a reference of common JQL recipes for assignee, sprint, status, priority, and date filters.

How do I create a Jira ticket with a description via the API?

POST to /rest/api/3/issue with the project key, summary, issue type, and a description formatted in Atlassian Document Format. Alternatively, use acli jira workitem create, which accepts plain text without ADF.

Should I use curl or acli for Jira automation?

Prefer curl for most operations since it has fewer dependencies and clearer behavior. Use acli only for bulk transitions with --jql and --yes flags, and for certain sprint operations that are awkward over the raw API.

Why does my Jira API request return a 401 or 403 error?

A 401 or 403 means authentication failed. Verify that ATLASSIAN_DOMAIN, ATLASSIAN_EMAIL, and ATLASSIAN_API_TOKEN are set, or run acli auth status to check CLI authentication. Never print the token values themselves when diagnosing.

Can I transition multiple Jira issues at once?

Yes, bulk transitions are supported through acli jira workitem transition with a --jql filter and --yes confirmation. With curl you must loop over search results and POST each transition individually.