jira-integration

Agent Skill: Comprehensive Jira integration through lightweight Python scripts. AUTOMATICALLY TRIGGER when user mentions Jira URLs like 'https://jira.*/browse/*', 'https://*.atlassian.net/browse/*', or issue keys like 'PROJ-123'. Use when searching issues (JQL), getting/updating issue details, creating issues, transitioning status, adding comments, logging worklogs, managing sprints and boards, creating issue links, or formatting Jira wiki markup. If authentication fails, offer to configure credentials interactively. Supports both Jira Cloud and Server/Data Center with automatic authentication detection. By Netresearch.

Jira Integration Skill

Comprehensive Jira integration through lightweight Python CLI scripts.

Note: Run scripts from skills/jira-communication/, or use full paths from repo root.

Auto-Trigger Patterns

AUTOMATICALLY ACTIVATE when user mentions:

Jira URLs: https://jira.*/browse/*, https://*.atlassian.net/browse/*
Issue keys: Pattern like PROJ-123, NRS-4167, ABC-1
Keywords: "Jira issue", "Jira ticket", "search Jira"

Authentication Failure Handling

CRITICAL: When authentication fails, DO NOT just display the error. Instead:

Detect failure - Look for "Missing required variable" or 401/403 responses
Offer help - Ask: "Would you like me to help configure Jira credentials?"
Run interactive setup - uv run skills/jira-communication/scripts/core/jira-setup.py

Sub-Skills

| Skill | Purpose | |-------|---------| | jira-communication | API operations via Python CLI scripts | | jira-syntax | Wiki markup syntax, templates, validation |

Scripts Reference

Core Operations

| Script | Purpose | |--------|---------| | jira-setup.py | Interactive credential setup | | jira-validate.py | Verify connection | | jira-issue.py | Get/update issue details | | jira-search.py | Search with JQL | | jira-worklog.py | Time tracking | | jira-attachment.py | Download attachments |

Workflow Operations

| Script | Purpose | |--------|---------| | jira-create.py | Create issues | | jira-transition.py | Change status | | jira-comment.py | Comments | | jira-link.py | Issue links | | jira-sprint.py | Sprint management | | jira-board.py | Board operations |

Syntax Note

Jira uses wiki markup, NOT Markdown. See skills/jira-syntax/SKILL.md for syntax guide.

Contributing: https://github.com/netresearch/jira-skill