# jira-wiki

jira-wiki is a Claude Code skill for formatting Jira descriptions, comments, and custom fields. It activates for questions about Jira text syntax.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 3 installs
- Author: SecKatie
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SecKatie/kmtools/tree/HEAD/jira-wiki/SKILL.md
- Updated: 2025-12-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/jira-wiki

## What it does

The skill explains Jira Wiki Markup for headings, links, lists, tables, code blocks, panels, and quotes. Jira uses its own notation, so Markdown formatting does not apply to these fields.

It includes sample layouts for status updates, bug reports, and decision records. Reference files cover the full syntax, templates, and emoticons. The skill is triggered by requests to format Jira text or link to a user, issue, or attachment.

## Requirements
- Works with: Jira

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add SecKatie/kmtools --skill jira-wiki -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add SecKatie/kmtools --skill jira-wiki -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SecKatie/kmtools jira-wiki
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/SecKatie/kmtools --path jira-wiki
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add SecKatie/kmtools --skill jira-wiki -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/SecKatie/kmtools/tree/HEAD/jira-wiki/SKILL.md

## When to use it
- format a Jira issue description with headings and lists
- create a table for expected and actual results
- add a user, issue, or attachment link
- draft a status update or bug report template

## Example prompts
- Format this issue description in Jira syntax and add a table for expected and actual results.
- Add a code block and a link to `PROJ-123` in this Jira comment.
- Draft a Jira status template with headings and next steps.

## Similar
- [jira-syntax](https://affpapa.org/en/nevibecode/skills/jira-syntax.md) — skill · 614 installs
- [Jira Automation](https://affpapa.org/en/nevibecode/skills/claude-office-skills-jira-automation.md) — skill · 4900 installs
- [orca-jira](https://affpapa.org/en/nevibecode/skills/orca-jira.md) — skill · 871 installs
- [jira-tickets](https://affpapa.org/en/nevibecode/skills/jira-tickets.md) — skill · 825 installs
- [jira-cli](https://affpapa.org/en/nevibecode/skills/jira-cli.md) — skill · 646 installs
- [jira-communication](https://affpapa.org/en/nevibecode/skills/jira-communication.md) — skill · 588 installs

---
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
