Skip to content
Back to search

jira

SkillWorks with Claude CodeGitHub

Comprehensive Jira integration with auto-detection of issue keys

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/netresearch--jira-skill/badge.svg)](/listings/netresearch--jira-skill)

HTML

<a href="/listings/netresearch--jira-skill"><img src="/api/listings/netresearch--jira-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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
/plugin install jira-integration@netresearch-claude-code-marketplace

Without a marketplace

Since Claude Code 2.1.157 a plugin directory under your personal skills directory loads on its own, including the hooks this repo ships:

mkdir -p ~/.claude/skills
git clone https://github.com/netresearch/jira-skill.git \
  ~/.claude/skills/jira-integration

It loads as `jira-integration@skills-dir` on the next session. Update with `git -C ~/.claude/skills/jira-integration pull` and start a new session; remove it by deleting the directory. This route has no `claude plugin update`.

npx ([skills.sh](https://skills.sh))

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

> **Limitation:** `npx skills` installs `SKILL.md`-based skills only. This repo also ships `hooks`, which it does not install — use the marketplace or the skills directory for those.

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 https://github.com/netresearch/jira-skill.git

Composer (PHP Projects)

composer require netresearch/jira-skill

Requires [netresearch/composer-agent-skill-plugin](https://github.com/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](https://github.com/netresearch/node-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"]
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 24 lines
  1. {
  2. "name": "jira",
  3. "version": "5.2.0",
  4. "description": "Comprehensive Jira integration with auto-detection of issue keys",
  5. "author": {
  6. "name": "Netresearch DTT GmbH",
  7. "url": "https://www.netresearch.de/"
  8. },
  9. "repository": "https://github.com/netresearch/jira-skill",
  10. "license": "(MIT AND CC-BY-SA-4.0)",
  11. "keywords": [
  12. "jira",
  13. "atlassian",
  14. "issue-tracking",
  15. "project-management",
  16. "wiki-markup",
  17. "syntax-validation",
  18. "templates"
  19. ],
  20. "skills": [
  21. "./skills/jira-communication",
  22. "./skills/jira-syntax"
  23. ]
  24. }
README.md · README · 334 lines
  1. <!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
  2. <!-- SPDX-FileCopyrightText: Netresearch DTT GmbH -->
  3. # Jira Integration Plugin for Claude Code
  4. [![CI](https://github.com/netresearch/jira-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/netresearch/jira-skill/actions/workflows/ci.yml)
  5. [![License](https://img.shields.io/badge/License-MIT%20%2B%20CC--BY--SA--4.0-blue.svg)](#license)
  6. [![Python](https://img.shields.io/badge/python-3.11%7C3.12%7C3.13%7C3.14-blue)](https://www.python.org/)
  7. A Claude Code plugin providing comprehensive Jira integration through two specialized skills.
  8. ## Plugin Structure
  9. | Skill | Purpose |
  10. |-------|---------|
  11. | `jira-communication` | API operations via Python CLI scripts |
  12. | `jira-syntax` | Wiki markup syntax, templates, validation |
  13. Each skill has its own `SKILL.md` with trigger conditions and usage instructions. Claude Code auto-discovers and activates skills based on context.
  14. ## 🔌 Skill Compatibility
  15. 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.
  16. **Supported Platforms:**
  17. - ✅ Claude Code (Anthropic)
  18. - ✅ Cursor
  19. - ✅ GitHub Copilot
  20. - ✅ Other skills-compatible AI agents
  21. > Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.
  22. ## Features
  23. - **Zero MCP overhead** - Scripts invoked via Bash, no tool descriptions loaded
  24. - **Fast execution** - No Docker container spin-up
  25. - **Full API coverage** - All common Jira operations supported
  26. - **Jira Server/DC + Cloud** - Works with both deployment types
  27. ## Installation
  28. ### Marketplace (Recommended)
  29. Add the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:
  30. ```bash
  31. # Claude Code
  32. /plugin marketplace add netresearch/claude-code-marketplace
  33. /plugin install jira-integration@netresearch-claude-code-marketplace
  34. ```
  35. ### Without a marketplace
  36. Since Claude Code 2.1.157 a plugin directory under your personal skills directory loads on its own, including the hooks this repo ships:
  37. ```bash
  38. mkdir -p ~/.claude/skills
  39. git clone https://github.com/netresearch/jira-skill.git \
  40. ~/.claude/skills/jira-integration
  41. ```
  42. It loads as `jira-integration@skills-dir` on the next session. Update with `git -C ~/.claude/skills/jira-integration pull` and start a new session; remove it by deleting the directory. This route has no `claude plugin update`.
  43. ### npx ([skills.sh](https://skills.sh))
  44. Install with any [Agent Skills](https://agentskills.io)-compatible agent:
  45. ```bash
  46. npx skills add https://github.com/netresearch/jira-skill --skill jira-communication
  47. npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax
  48. ```
  49. > **Limitation:** `npx skills` installs `SKILL.md`-based skills only. This repo also ships `hooks`, which it does not install — use the marketplace or the skills directory for those.
  50. ### Download Release
  51. Download the [latest release](https://github.com/netresearch/jira-skill/releases/latest) and extract to your agent's skills directory.
  52. ### Git Clone
  53. ```bash
  54. git clone https://github.com/netresearch/jira-skill.git
  55. ```
  56. ### Composer (PHP Projects)
  57. ```bash
  58. composer require netresearch/jira-skill
  59. ```
  60. Requires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).
  61. ### npm (Node Projects)
  62. ```bash
  63. npm install --save-dev \
  64. @netresearch/agent-skill-coordinator \
  65. github:netresearch/jira-skill
  66. ```
  67. Requires [@netresearch/agent-skill-coordinator](https://github.com/netresearch/node-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:
  68. ```json
  69. {
  70. "pnpm": {
  71. "onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
  72. }
  73. }
  74. ```
  75. ## Quick Start
  76. > **Note:** Run commands from `skills/jira-communication/`, or prefix paths with `skills/jira-communication/` from the repo root.
  77. ```bash
  78. # Search issues
  79. uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'"
  80. # Get issue details
  81. uv run scripts/core/jira-issue.py get PROJ-123
  82. # Add worklog
  83. uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Code review"
  84. # Create issue
  85. uv run scripts/workflow/jira-create.py issue PROJ "Fix bug" --type Bug --priority High
  86. ```
  87. ## Available Scripts
  88. ### Core Operations (scripts/core/)
  89. | Script | Commands | Usage |
  90. |--------|----------|-------|
  91. | `jira-setup.py` | (default) | Interactive credential setup |
  92. | `jira-validate.py` | (default) | Validate environment setup |
  93. | `jira-issue.py` | get, update | Get and update issues |
  94. | `jira-search.py` | query | JQL search |
  95. | `jira-worklog.py` | add, list | Time tracking |
  96. | `jira-attachment.py` | download | Download issue attachments |
  97. ### Workflow Operations (scripts/workflow/)
  98. | Script | Commands | Usage |
  99. |--------|----------|-------|
  100. | `jira-create.py` | issue | Create new issues |
  101. | `jira-transition.py` | list, do | Change issue status |
  102. | `jira-comment.py` | add, list | Issue comments |
  103. | `jira-sprint.py` | list, issues, current | Sprint operations |
  104. | `jira-board.py` | list, issues | Board operations |
  105. ### Utility Operations (scripts/utility/)
  106. | Script | Commands | Usage |
  107. |--------|----------|-------|
  108. | `jira-fields.py` | search, list | Find field IDs |
  109. | `jira-user.py` | me, get | User information |
  110. | `jira-link.py` | create, list-types | Issue linking |
  111. ## Common Options
  112. All scripts support:
  113. - `--json` - Output as JSON
  114. - `--quiet` / `-q` - Minimal output
  115. - `--env-file PATH` - Custom environment file
  116. - `--debug` - Show detailed errors
  117. - `--help` - Show command help
  118. Write operations also support:
  119. - `--dry-run` - Preview changes without executing
  120. ## Script Usage Examples
  121. ### Search and Filter
  122. ```bash
  123. # Find open bugs in project
  124. uv run scripts/core/jira-search.py query "project = PROJ AND type = Bug AND status != Done"
  125. # Find my assigned issues
  126. uv run scripts/core/jira-search.py query "assignee = currentUser()"
  127. # Output as JSON for processing
  128. uv run scripts/core/jira-search.py query "project = PROJ" --json --max-results 100
  129. ```
  130. ### Issue Management
  131. ```bash
  132. # Get issue details
  133. uv run scripts/core/jira-issue.py get PROJ-123
  134. # Update issue fields (dry-run first)
  135. uv run scripts/core/jira-issue.py update PROJ-123 --labels "urgent,backend" --dry-run
  136. # Create new issue
  137. uv run scripts/workflow/jira-create.py issue PROJ "Implement feature X" --type Story --priority Medium
  138. ```
  139. ### Time Tracking
  140. ```bash
  141. # Log time worked
  142. uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Implemented core logic"
  143. # View worklogs
  144. uv run scripts/core/jira-worklog.py list PROJ-123
  145. ```
  146. ### Workflow Transitions
  147. ```bash
  148. # List available transitions
  149. uv run scripts/workflow/jira-transition.py list PROJ-123
  150. # Transition issue (dry-run first)
  151. uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
  152. # Execute transition
  153. uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress"
  154. ```
  155. ### Comments
  156. ```bash
  157. # Add comment
  158. uv run scripts/workflow/jira-comment.py add PROJ-123 "Investigation complete - root cause identified"
  159. # List recent comments
  160. uv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5
  161. ```
  162. ### Sprint & Board Operations
  163. ```bash
  164. # List boards for project
  165. uv run scripts/workflow/jira-board.py list --project PROJ
  166. # Get board issues
  167. uv run scripts/workflow/jira-board.py issues 42
  168. # List sprints
  169. uv run scripts/workflow/jira-sprint.py list 42 --state active
  170. # Get sprint issues
  171. uv run scripts/workflow/jira-sprint.py issues 123
  172. # Get current sprint
  173. uv run scripts/workflow/jira-sprint.py current 42
  174. ```
  175. ### Utility Operations
  176. ```bash
  177. # Search for custom fields
  178. uv run scripts/utility/jira-fields.py search "story points"
  179. # List all custom fields
  180. uv run scripts/utility/jira-fields.py list --type custom
  181. # Get current user info
  182. uv run scripts/utility/jira-user.py me
  183. # List available link types
  184. uv run scripts/utility/jira-link.py list-types
  185. # Create issue link
  186. uv run scripts/utility/jira-link.py create PROJ-123 PROJ-456 --type "Blocks" --dry-run
  187. ```
  188. ## Related Skills
  189. - **jira-syntax** - Jira wiki markup validation and templates (unchanged)
  190. ## Troubleshooting
  191. ### "uv not found"
  192. Install uv:
  193. ```bash
  194. pip install uv
  195. ```
  196. ### "Environment file not found"
  197. Create `~/.env.jira` with your credentials.
  198. ### "Authentication failed"
  199. 1. Verify JIRA_URL is correct
  200. 2. For Cloud: JIRA_USERNAME is your email
  201. 3. For Server/DC: Use JIRA_PERSONAL_TOKEN instead
  202. 4. Regenerate your API token if expired
  203. ### Import errors when running scripts
  204. Run scripts from the skill directory:
  205. ```bash
  206. cd skills/jira-communication
  207. uv run scripts/core/jira-issue.py get PROJ-123
  208. ```
  209. ## Governance and policies
  210. This repository follows the Netresearch organisation policies:
  211. - [Governance](https://github.com/netresearch/.github/blob/main/GOVERNANCE.md): ownership, roles, how decisions are made and disputes resolved, and continuity.
  212. - [Roadmap](https://github.com/netresearch/.github/blob/main/ROADMAP.md): planned and explicitly excluded work for the coming year.
  213. - [Handling of dependency and code analysis findings](https://github.com/netresearch/.github/blob/main/SECURITY.md#handling-of-dependency-and-code-analysis-findings): thresholds, deadlines and the exception process for dependency (SCA) and static analysis (SAST) findings.
  214. - [Secret management](https://github.com/netresearch/.github/blob/main/SECURITY.md#secret-management): how CI and release credentials are stored, accessed and rotated.
  215. - [Access roster](https://github.com/netresearch/.github/blob/main/docs/access-roster.md): who holds administrative access to this repository and the organisation.
  216. The security assurance case for this plugin (how Jira credentials are read and where they are sent, trust boundaries, countermeasures and limits) is in [docs/SECURITY-ASSURANCE.md](docs/SECURITY-ASSURANCE.md).
  217. Checks that run in this repository:
  218. - Every pull request: Skill Validation (`lint.yml` and `validate.yml`: skill structure, plugin manifest sync, markdownlint, yamllint, actionlint, JSON syntax, version parity, ShellCheck, ruff; `validate.yml` runs ShellCheck at style severity) and Eval Validation (`eval-validate.yml`).
  219. - Pull requests to `main`: CI (`ci.yml`: the pytest suite on Python 3.11 to 3.14 and bandit at severity medium over the scripts), CodeQL for `actions` and `python` (`codeql.yml`), `security.yml` with Betterleaks (secret scanning), zizmor (workflow static analysis), dependency review, Composer Audit and Opengrep SAST, Harness Verification (`harness-verify.yml`) and Template Drift (`check-template-drift.yml`). The organisation's security policy sets when dependency review and Opengrep fail: see [dependencies](https://github.com/netresearch/.github/blob/main/SECURITY.md#dependencies-software-composition-analysis) and [static analysis (SAST)](https://github.com/netresearch/.github/blob/main/SECURITY.md#static-analysis-sast).
  220. - Also on every pull request: Labeler (`labeler.yml`), the DCO sign-off check, SonarCloud Code Analysis (with its code-scanning result check `SonarCloud`) and the CodeRabbit review status (GitHub Apps) and, for dependency-update pull requests, auto-merge (`auto-merge-deps.yml`).
  221. - Pull requests that change `skills/jira-communication/scripts/` or the workflow itself, and weekly: Dependency Audit (`dependency-audit.yml`) runs pip-audit over the PEP 723 dependencies of `skills/jira-communication/scripts`. Dependency review does not read PEP 723 blocks; this workflow covers them. OpenSSF Scorecard (`scorecard.yml`) and CodeQL (`codeql.yml`) also run weekly.
  222. ## License
  223. MIT
  224. ## Credits
  225. Developed and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).
  226. ---
  227. **Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**

Version history

  • v5.2.011/18/2026

  • v5.1.011/16/2026

  • v5.0.011/13/2026

  • v4.3.311/11/2026

  • v4.3.211/5/2026

  • v4.3.110/30/2026

  • v4.3.010/24/2026

  • v4.1.010/23/2026

  • v3.34.010/18/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.