jira

Manage Jira issues, sprints, and workflows via CLI or Atlassian MCP tools.

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/jwvdvuurst/CalculatorCollection --skill jira-jwvdvuurst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira
Source: https://github.com/jwvdvuurst/CalculatorCollection/tree/main/skills/jira
Command: npx skills add https://github.com/jwvdvuurst/CalculatorCollection --skill jira-jwvdvuurst

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interacting with Jira through natural language requires knowing the right commands, API tools, and workflow rules. This Skill removes that friction by detecting the available backend (jira CLI or Atlassian MCP) and guiding issue creation, updates, transitions, and searches safely. ## Core Features & Use Cases - Dual Backend Support: Automatically detects whether to use the jira CLI or Atlassian MCP tools and adapts commands accordingly. - Full Issue Lifecycle: View, create, update, transition, assign, and comment on issues, plus sprint and JQL query support. - Safety Guardrails: Enforces fetch-before-modify, approval-before-update, and account-ID lookup rules to prevent silent failures and notification storms. - Use Case: A developer says "move PROJ-123 to done and add a comment." The Skill fetches the issue, retrieves valid transitions, executes the correct transition ID, and adds the comment. ## Quick Start Ask the assistant to show the details of a Jira issue like PROJ-123 or list your in-progress tickets.

Frequently Asked Questions about jira

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

FAQPage Schema
How do I create a Jira ticket from the command line?

Use jira issue create with flags like -t for type, -s for summary, and -b for description. For multi-line descriptions, write the content to a file in /tmp first and pass it with $(cat /tmp/file), since the CLI struggles with multi-line strings.

How do I move a Jira issue to Done?

With the CLI, run jira issue move ISSUE-KEY "Done". With MCP, first call getTransitionsForJiraIssue to get valid transition IDs, then call transitionJiraIssue with the correct ID, since workflows may require intermediate states.

Can I use Jira without installing the CLI?

Yes, if the Atlassian MCP server is configured, the Skill uses MCP tools like getJiraIssue and createJiraIssue instead. If neither backend is available, it guides you to install the jira CLI or configure Atlassian MCP.

Why does Jira issue assignment fail with a display name?

The Atlassian MCP only accepts account IDs for assignment, not display names. You must call lookupJiraAccountId with the user's email or name first, then pass the returned account ID to the create or edit operation.

How do I search Jira issues with JQL?

Use the searchJiraIssuesUsingJql MCP tool or jira issue list -q with a JQL string, such as "assignee = currentUser() AND status = 'In Progress'". The references include a full JQL field, operator, and function reference.

Can the Atlassian MCP create issue links between tickets?

No, the Atlassian MCP does not support creating issue links. Use the bundled jira-link-issues script with JIRA_BASE_URL, JIRA_USER, and JIRA_API_TOKEN environment variables to link issues via the REST API.