# jira-syntax

This skill turns Markdown into Jira wiki markup, applies issue templates, and checks syntax before posting. Use it for Jira descriptions and comments.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 581 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-syntax/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/jira-syntax

## What it does

\`jira-syntax` prepares text for Jira’s wiki markup instead of Markdown. It covers headings, lists, links, tables, code blocks, issue links, and user mentions. The package also includes templates for bug reports and feature requests, with sections suited to each document type.

Before content is posted, run `scripts/validate-jira-syntax.sh` on the file. Validation must remain a separate step rather than being chained to the posting command. That matters because the script checks the markup; it does not submit the Jira content.

Use `jira-communication` for API actions. This skill is for authoring, formatting, templates, and syntax checks.

## Requirements
- Works with: Jira

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-syntax -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-syntax/SKILL.md

## When to use it
- convert Markdown into Jira wiki markup
- draft a bug report from the provided template
- structure a feature request with the right sections
- check links, tables, and lists before posting
- fix invalid Jira markup

## Example prompts
- Convert this Markdown into Jira wiki markup for the issue description.
- Draft a bug report using `templates/bug-report-template.md`.
- Run the Jira syntax check on `jira-comment.txt` before it is posted.

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 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