# jira-expert

jira-expert — a skill for Claude Code and five other platforms guides Jira configurations, JQL construction, and automation rules. It handles offline audits of board exports and task quality.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 133 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/project-management/jira-expert/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-jira-expert

## What it does

The skill assists with Scrum or Kanban board setups, custom status lifecycles, advanced JQL filters, and automation rules designed to prevent trigger loops. Advice adapts to both Jira Cloud and Data Center environments, factoring in terminology shifts like spaces and work items.

The toolset includes three offline Python scripts: `board_optimizer.py`, `issue_quality_checker.py`, and `workflow_analyzer.py`. They operate entirely on local JSON export files. The scripts measure column WIP limits, inspect issues for acceptance criteria, and calculate rework rates from transition logs.

Administrative schemes and organization-wide automation are not available via MCP tools. Because of this boundary, the assistant outputs exact structural configurations meant for manual entry in settings or calls via the Jira REST API.

## Requirements
- Works with: Jira

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill jira-expert -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill jira-expert -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills project-management/jira-expert/SKILL.md
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path project-management/jira-expert
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill jira-expert -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/borghei/Claude-Skills/tree/HEAD/project-management/jira-expert/SKILL.md

## When to use it
- construct and debug multi-condition JQL queries
- inspect exported board JSON files for missing WIP limits
- grade issue records against description and acceptance criteria checks
- identify workflow bottlenecks from transition histories
- design automation rules that avoid trigger loops

## Example prompts
- Write a JQL filter to surface unresolved sprint issues untouched for two weeks
- python3 project-management/jira-expert/scripts/board_optimizer.py --board assets/sample_board.json
- Audit issue descriptions and acceptance criteria using issue_quality_checker.py --issues tasks.json

## Similar
- [jira](https://affpapa.org/en/nevibecode/skills/odyssey4me-jira.md) — skill · 139 installs
- [jira-integration](https://affpapa.org/en/nevibecode/skills/jira-integration.md) — skill · 6800 installs
- [atlassian-mcp](https://affpapa.org/en/nevibecode/skills/atlassian-mcp.md) — skill · 4800 installs
- [c-jira](https://affpapa.org/en/nevibecode/skills/c-jira.md) — skill · ★ 179 repo stars
- [Jira Automation](https://affpapa.org/en/nevibecode/skills/claude-office-skills-jira-automation.md) — skill · 4900 installs
- [jira-cli](https://affpapa.org/en/nevibecode/skills/jira-cli.md) — skill · 646 installs

## Other versions with the same name
- [jira-expert · alirezarezvani](https://affpapa.org/en/nevibecode/skills/jira-expert.md) — 823 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 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
