jira-tasks

name	jira-tasks
description	Jira issue tracking and project management. Use for creating, searching, updating, and commenting on Jira issues. Supports JQL queries for advanced searching.
allowed-tools	Bash(python *)

Jira Issue Tracking

Authentication

Set these environment variables:

• JIRA_URL — Your Jira instance URL (e.g., https://yourcompany.atlassian.net)
• JIRA_EMAIL — Your Atlassian account email
• JIRA_API_TOKEN — API token from https://id.atlassian.com/manage-profile/security/api-tokens

---

Available Scripts

All scripts are in .claude/skills/jira-tasks/scripts/

search_issues.py - Search with JQL

python .claude/skills/jira-tasks/scripts/search_issues.py --jql "JQL_QUERY" [--max-results N]

# Examples:
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "type = Bug AND status != Done AND created >= -7d"
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "labels = question AND created >= -30d" --max-results 50
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "assignee = currentUser() AND status = 'In Progress'"

---

Client Library Functions

The jira_client.py module provides:

Function	Purpose
search_issues(jql, max_results)	Search issues using JQL
get_issue(issue_key)	Get issue details
create_issue(project, summary, ...)	Create a new issue
update_issue(issue_key, fields)	Update an existing issue
add_comment(issue_key, comment)	Add a comment to an issue

---

JQL Quick Reference

Common Patterns

# Recent bugs
type = Bug AND created >= -7d ORDER BY created DESC

# Open tasks
status != Done AND status != Closed

# By label
labels IN ("helpdesk", "question")

# Text search
summary ~ "timeout" OR description ~ "timeout"

# Assigned to me
assignee = currentUser() AND status != Done

# Stale issues
updated <= -90d AND status != Done

Operators

Operator	Meaning	Example
=	Equals	status = Done
!=	Not equals	status != Done
~	Contains text	summary ~ "error"
IN	In list	status IN ("Open", "In Progress")
>=	Greater/equal	created >= -7d
ORDER BY	Sort	ORDER BY created DESC

---

Common Workflows

1. Find Related Issues

python search_issues.py --jql "text ~ 'authentication timeout' AND created >= -30d"

2. Create a Follow-up Task

from jira_client import create_issue
create_issue(
    project="HELP",
    summary="Update knowledge base — refund policy",
    description="A customer asked about the refund timeline and our docs were outdated.",
    issue_type="Task",
    priority="Medium",
)

3. Track Question Patterns

python search_issues.py --jql "labels = helpdesk AND created >= -30d" --max-results 100

---

Quick Reference

Goal	Command
Search issues	search_issues.py --jql "type = Bug"
Recent issues	search_issues.py --jql "created >= -7d"
By label	search_issues.py --jql "labels = helpdesk"