Jira Skill
Agent Skill for intelligent Jira integration with MCP config and wiki markup | Claude Code compatible
Ask AI about Jira Skill
Powered by Claude Β· Grounded in docs
I know everything about Jira Skill. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 withskills/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
Script Usage Examples
Search and Filter
# Find open bugs in project
uv run scripts/core/jira-search.py query "project = PROJ AND type = Bug AND status != Done"
# Find my assigned issues
uv run scripts/core/jira-search.py query "assignee = currentUser()"
# Output as JSON for processing
uv run scripts/core/jira-search.py query "project = PROJ" --json --max-results 100
Issue Management
# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123
# Update issue fields (dry-run first)
uv run scripts/core/jira-issue.py update PROJ-123 --labels "urgent,backend" --dry-run
# Create new issue
uv run scripts/workflow/jira-create.py issue PROJ "Implement feature X" --type Story --priority Medium
Time Tracking
# Log time worked
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Implemented core logic"
# View worklogs
uv run scripts/core/jira-worklog.py list PROJ-123
Workflow Transitions
# List available transitions
uv run scripts/workflow/jira-transition.py list PROJ-123
# Transition issue (dry-run first)
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
# Execute transition
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress"
Comments
# Add comment
uv run scripts/workflow/jira-comment.py add PROJ-123 "Investigation complete - root cause identified"
# List recent comments
uv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5
Sprint & Board Operations
# List boards for project
uv run scripts/workflow/jira-board.py list --project PROJ
# Get board issues
uv run scripts/workflow/jira-board.py issues 42
# List sprints
uv run scripts/workflow/jira-sprint.py list 42 --state active
# Get sprint issues
uv run scripts/workflow/jira-sprint.py issues 123
# Get current sprint
uv run scripts/workflow/jira-sprint.py current 42
Utility Operations
# Search for custom fields
uv run scripts/utility/jira-fields.py search "story points"
# List all custom fields
uv run scripts/utility/jira-fields.py list --type custom
# Get current user info
uv run scripts/utility/jira-user.py me
# List available link types
uv run scripts/utility/jira-link.py list-types
# Create issue link
uv run scripts/utility/jira-link.py create PROJ-123 PROJ-456 --type "Blocks" --dry-run
Related Skills
- jira-syntax - Jira wiki markup validation and templates (unchanged)
Troubleshooting
"uv not found"
Install uv:
pip install uv
"Environment file not found"
Create ~/.env.jira with your credentials.
"Authentication failed"
- Verify JIRA_URL is correct
- For Cloud: JIRA_USERNAME is your email
- For Server/DC: Use JIRA_PERSONAL_TOKEN instead
- Regenerate your API token if expired
Import errors when running scripts
Run scripts from the skill directory:
cd skills/jira-communication
uv run scripts/core/jira-issue.py get PROJ-123
License
MIT
Credits
Developed and maintained by Netresearch DTT GmbH.
Made with β€οΈ for Open Source by Netresearch
