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.
/plugin marketplace add netresearch/claude-code-marketplace/plugin install netresearch-skills-bundle@netresearch-claude-code-marketplaceThis skill inherits all available tools. When active, it can use any tool Claude has access to.
AGENTS.mdCHANGELOG.mdCLAUDE.mdLICENSEMIGRATION.mdPRD.mdREADME.mdcomposer.jsonskills/jira-communication/AGENTS.mdskills/jira-communication/references/jql-quick-reference.mdskills/jira-communication/references/troubleshooting.mdskills/jira-communication/scripts/core/jira-attachment.pyskills/jira-communication/scripts/core/jira-issue.pyskills/jira-communication/scripts/core/jira-search.pyskills/jira-communication/scripts/core/jira-setup.pyskills/jira-communication/scripts/core/jira-validate.pyskills/jira-communication/scripts/core/jira-worklog.pyskills/jira-communication/scripts/lib/__init__.pyskills/jira-communication/scripts/lib/client.pyskills/jira-communication/scripts/lib/config.pyComprehensive Jira integration through lightweight Python CLI scripts.
AUTOMATICALLY ACTIVATE when user mentions:
https://jira.*/browse/*, https://*.atlassian.net/browse/*, https://*/jira/browse/*PROJ-123, NRS-4167, ABC-1 (uppercase letters + hyphen + numbers)Example triggers:
CRITICAL: When authentication fails, DO NOT just display the error. Instead:
uv run skills/jira-communication/scripts/core/jira-setup.py~/.env.jira with secure permissions (600)This plugin contains two specialized skills:
| Skill | Purpose |
|---|---|
jira-communication | API operations via Python CLI scripts |
jira-syntax | Wiki markup syntax, templates, validation |
# Install uv (Python package runner)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Configure credentials in ~/.env.jira
JIRA_URL=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-api-token
# Validate setup
uv run scripts/core/jira-validate.py --verbose
# Search issues
uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'"
# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123
# Add worklog
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Code review"
# Create issue
uv run scripts/workflow/jira-create.py issue PROJ "Fix bug" --type Bug --priority High
# Transition issue
uv run scripts/workflow/jira-transition.py PROJ-123 "In Progress"
| Script | Purpose |
|---|---|
jira-setup.py | Interactive credential setup (run when auth fails) |
jira-validate.py | Verify connection and credentials |
jira-issue.py | Get or update issue details |
jira-search.py | Search with JQL queries |
jira-worklog.py | Time tracking entries |
jira-comment.py | Add/list comments |
| Script | Purpose |
|---|---|
jira-create.py | Create new issues |
jira-transition.py | Change issue status |
jira-link.py | Create/list issue links |
jira-sprint.py | Sprint management |
jira-board.py | Board operations |
Important: Jira uses wiki markup, NOT Markdown.
| Jira Syntax | Purpose |
|---|---|
h2. Title | Heading (NOT ## Title) |
*bold* | Bold (NOT **bold**) |
{code:java}...{code} | Code block (NOT triple backticks) |
[text|url] | Link |
[PROJ-123] | Issue link |
See skills/jira-syntax/SKILL.md for complete syntax guide.
Contributing: Improvements to this skill should be submitted to the source repository: https://github.com/netresearch/jira-skill