jira-tasks - SKILL.md Agent Skill

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"`