PHPackages netresearch/agent-jira-skill - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. netresearch/agent-jira-skill ActiveAi-agent-skill netresearch/agent-jira-skill ============================ Netresearch AI skill for Jira API operations and wiki markup syntax v3.8.0(1mo ago)3810312[1 issues](https://github.com/netresearch/jira-skill/issues)MITPythonCI passing Since Nov 26Pushed 1mo ago1 watchersCompare [ Source](https://github.com/netresearch/jira-skill)[ Packagist](https://packagist.org/packages/netresearch/agent-jira-skill)[ RSS](/packages/netresearch-agent-jira-skill/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (33)Used By (0) Jira Integration Plugin for Claude Code ======================================= [](#jira-integration-plugin-for-claude-code) [![CI](https://github.com/netresearch/jira-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/netresearch/jira-skill/actions/workflows/ci.yml)[![License](https://camo.githubusercontent.com/6e8aea34fb51a8ac64bef0c72b3e2fef0c2863903155a3537069fbadd121d95c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d495425323025324225323043432d2d42592d2d53412d2d342e302d626c75652e737667)](#license)[![Python](https://camo.githubusercontent.com/46a12067a96af1d54cb6f15b09de644375f3956fa9c1ba4c04de8d62a41f82aa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f707974686f6e2d332e3130253743332e3131253743332e3132253743332e31332d626c7565)](https://www.python.org/) A Claude Code plugin providing comprehensive Jira integration through two specialized skills. Plugin Structure ---------------- [](#plugin-structure) SkillPurpose`jira-communication`API operations via Python CLI scripts`jira-syntax`Wiki markup syntax, templates, validationEach skill has its own `SKILL.md` with trigger conditions and usage instructions. Claude Code auto-discovers and activates skills based on context. 🔌 Skill Compatibility --------------------- [](#-skill-compatibility) The skills contained in this plugin follow the [Agent Skills open standard](https://agentskills.io) 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 -------- [](#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 ------------ [](#installation) ### Marketplace (Recommended) [](#marketplace-recommended) Add the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills: ``` # Claude Code /plugin marketplace add netresearch/claude-code-marketplace ``` ### npx ([skills.sh](https://skills.sh)) [](#npx-skillssh) Install with any [Agent Skills](https://agentskills.io)-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-release) Download the [latest release](https://github.com/netresearch/jira-skill/releases/latest) and extract to your agent's skills directory. ### Git Clone [](#git-clone) ``` git clone https://github.com/netresearch/jira-skill.git ``` ### Composer (PHP Projects) [](#composer-php-projects) ``` composer require netresearch/jira-skill ``` Requires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin). Quick Start ----------- [](#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 ----------------- [](#available-scripts) ### Core Operations (scripts/core/) [](#core-operations-scriptscore) ScriptCommandsUsage`jira-setup.py`(default)Interactive credential setup`jira-validate.py`(default)Validate environment setup`jira-issue.py`get, updateGet and update issues`jira-search.py`queryJQL search`jira-worklog.py`add, listTime tracking`jira-attachment.py`downloadDownload issue attachments### Workflow Operations (scripts/workflow/) [](#workflow-operations-scriptsworkflow) ScriptCommandsUsage`jira-create.py`issueCreate new issues`jira-transition.py`list, doChange issue status`jira-comment.py`add, listIssue comments`jira-sprint.py`list, issues, currentSprint operations`jira-board.py`list, issuesBoard operations### Utility Operations (scripts/utility/) [](#utility-operations-scriptsutility) ScriptCommandsUsage`jira-fields.py`search, listFind field IDs`jira-user.py`me, getUser information`jira-link.py`create, list-typesIssue linkingCommon Options -------------- [](#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 --------------------- [](#script-usage-examples) ### Search and Filter [](#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 [](#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 [](#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 [](#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 [](#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 [](#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 [](#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 -------------- [](#related-skills) - **jira-syntax** - Jira wiki markup validation and templates (unchanged) Troubleshooting --------------- [](#troubleshooting) ### "uv not found" [](#uv-not-found) Install uv: ``` pip install uv ``` ### "Environment file not found" [](#environment-file-not-found) Create `~/.env.jira` with your credentials. ### "Authentication failed" [](#authentication-failed) 1. Verify JIRA\_URL is correct 2. For Cloud: JIRA\_USERNAME is your email 3. For Server/DC: Use JIRA\_PERSONAL\_TOKEN instead 4. Regenerate your API token if expired ### Import errors when running scripts [](#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 ------- [](#license) MIT Credits ------- [](#credits) Developed and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/). --- **Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)** ### Health Score 50 — FairBetter than 95% of packages Maintenance98 Actively maintained with recent releases Popularity27 Limited adoption so far Community21 Small or concentrated contributor base Maturity46 Maturing project, gaining track record Bus Factor1 Top contributor holds 60.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Total 27 Last Release 36d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/acffee6a64e18f21593794b335dd8786001148f7df89fd8372a54d3dd09d91a4?d=identicon)[netresearch](/maintainers/netresearch) ![](https://www.gravatar.com/avatar/efd68399f95aa07110668d9af1a47a8030d8df5ec5af4b28e821d442d787583a?d=identicon)[team-mage](/maintainers/team-mage) --- Top Contributors [![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (127 commits)")[![powli](https://avatars.githubusercontent.com/u/4511053?v=4)](https://github.com/powli "powli (56 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (9 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)")[![magicsunday](https://avatars.githubusercontent.com/u/564393?v=4)](https://github.com/magicsunday "magicsunday (4 commits)")[![Sebastian80](https://avatars.githubusercontent.com/u/6400300?v=4)](https://github.com/Sebastian80 "Sebastian80 (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![khoi](https://avatars.githubusercontent.com/u/6994441?v=4)](https://github.com/khoi "khoi (2 commits)")[![tripleawwy](https://avatars.githubusercontent.com/u/43851917?v=4)](https://github.com/tripleawwy "tripleawwy (1 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (1 commits)")[![ozgb](https://avatars.githubusercontent.com/u/79094698?v=4)](https://github.com/ozgb "ozgb (1 commits)")[![alajovic](https://avatars.githubusercontent.com/u/7736090?v=4)](https://github.com/alajovic "alajovic (1 commits)") --- Tags agent-skillsai-agentatlassianclaude-code-skilljiramcpopen-standardproject-managementskill ### Embed Badge ![Health badge](/badges/netresearch-agent-jira-skill/health.svg) ``` [![Health](https://phpackages.com/badges/netresearch-agent-jira-skill/health.svg)](https://phpackages.com/packages/netresearch-agent-jira-skill) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)