jira

Jira Integration Plugin for Claude Code

A Claude Code plugin providing comprehensive Jira integration through two specialized skills.

Plugin Structure

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

Each skill has its own SKILL.md with trigger conditions and usage instructions. Claude Code auto-discovers and activates skills based on context.

🔌 Skill Compatibility

The skills contained in this plugin follow the Agent Skills open standard originally developed by Anthropic and released for cross-platform use.

Supported Platforms:

• ✅ Claude Code (Anthropic)
• ✅ Cursor
• ✅ GitHub Copilot
• ✅ Other skills-compatible AI agents

Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.

Features

• Zero MCP overhead - Scripts invoked via Bash, no tool descriptions loaded
• Fast execution - No Docker container spin-up
• Full API coverage - All common Jira operations supported
• Jira Server/DC + Cloud - Works with both deployment types

Installation

Marketplace (Recommended)

Add the Netresearch marketplace once, then browse and install skills:

# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace

npx (skills.sh)

Install with any Agent Skills-compatible agent:

npx skills add https://github.com/netresearch/jira-skill --skill jira-communication
npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax

Download Release

Download the latest release and extract to your agent's skills directory.

Git Clone

git clone https://github.com/netresearch/jira-skill.git

Composer (PHP Projects)

composer require netresearch/jira-skill

Requires netresearch/composer-agent-skill-plugin.

npm (Node Projects)

npm install --save-dev \
  @netresearch/agent-skill-coordinator \
  github:netresearch/jira-skill

Requires @netresearch/agent-skill-coordinator, which discovers the skill in node_modules and registers it in AGENTS.md via a postinstall hook. For pnpm, also allowlist the coordinator's postinstall:

{
  "pnpm": {
    "onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
  }
}

Quick Start

Note: Run commands from skills/jira-communication/, or prefix paths with skills/jira-communication/ from the repo root.

# 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

Available Scripts

Core Operations (scripts/core/)

Script	Commands	Usage
jira-setup.py	(default)	Interactive credential setup
jira-validate.py	(default)	Validate environment setup
jira-issue.py	get, update	Get and update issues
jira-search.py	query	JQL search
jira-worklog.py	add, list	Time tracking
jira-attachment.py	download	Download issue attachments

Workflow Operations (scripts/workflow/)

Script	Commands	Usage
jira-create.py	issue	Create new issues
jira-transition.py	list, do	Change issue status
jira-comment.py	add, list	Issue comments
jira-sprint.py	list, issues, current	Sprint operations
jira-board.py	list, issues	Board operations

Utility Operations (scripts/utility/)

Script	Commands	Usage
jira-fields.py	search, list	Find field IDs
jira-user.py	me, get	User information
jira-link.py	create, list-types	Issue linking

Common Options

All scripts support:

• --json - Output as JSON
• --quiet / -q - Minimal output
• --env-file PATH - Custom environment file
• --debug - Show detailed errors
• --help - Show command help

Write operations also support:

• --dry-run - Preview changes without executing