# jira-communication

A skill that drives Jira through CLI scripts: issues, sprints, boards, comments, worklogs and attachments. Useful when MCP Atlassian is down or you run Jira Server/DC.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 551 installs · ★ 89
- Author: Netresearch DTT GmbH
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/netresearch/jira-skill/tree/HEAD/skills/jira-communication/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/jira-communication

## What it does

The skill hands your agent a set of Python scripts run through `uv run`. They come in three groups: core (`jira-issue.py`, `jira-search.py`, `jira-worklog.py`, `jira-attachment.py`, `jira-setup.py`, `jira-validate.py`), workflow (`jira-create.py`, `jira-transition.py`, `jira-comment.py`, `jira-move.py`, `jira-sprint.py`, `jira-board.py`, `jira-version.py`, `tempo-account.py`) and utility (`jira-user.py`, `jira-fields.py`, `jira-link.py`, `jira-weblink.py`, `jira-worklog-query.py`, `jira-watchers.py`, `jira-qa-gather.py`). Every script takes `--help`, `--json`, `--quiet` and `--debug`.

It fires on its own when a Jira URL or an issue key such as `PROJ-123` shows up. From there it picks a verb by intent: `jira-issue.py work KEY` to triage a ticket, `jira-issue.py qa KEY` to open a review, `jira-transition.py do` to move status. If the ticket is not yours, or sits in a status where nobody is on it, `work` prints a `!! CLAIM KEY` notice on stderr with the commands to assign yourself and start work.

You need Python 3.11+ and `uv`, plus API access to a Jira Server/DC or Cloud instance. `jira-setup.py` handles auth. Before any wiki markup is posted, three gates run: dashes that Jira would render as strikethrough get escaped, the markup and ticket language are linted, and the instance renders the text and refuses the post if it comes back struck through. `--force` downgrades the findings to warnings, `--no-auto-escape` keeps the markup verbatim.

## Requirements
- Works with: Jira, Atlassian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-communication -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/jira-communication/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/jira-communication/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-communication -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/jira-communication/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-communication -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/jira-communication/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install netresearch/jira-skill jira-communication
```

2. **Manually: put the files in place**
- File: `.github/skills/jira-communication/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-communication -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/netresearch/jira-skill --path skills/jira-communication
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/jira-communication/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-communication -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/netresearch/jira-skill/tree/HEAD/skills/jira-communication/SKILL.md

## When to use it
- triage a ticket and leave a comment as you work
- move an issue to another status in one call
- log time to a worklog and check the remaining estimate
- gather ticket data before a QA review
- create an issue or find one with a JQL search

## Example prompts
- Triage PROJ-123 and tell me what has already been done on it
- Move PROJ-123 to In Progress and log 30 minutes
- Find every open issue in the PROJ project and list them

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

From the same set: [netresearch/jira-skill](https://affpapa.org/en/nevibecode/by/netresearch/jira-skill.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md