# jira-syntax

Скилл переводит Markdown в разметку Jira, подставляет шаблоны и проверяет текст перед отправкой. Нужен для описаний, комментариев и заявок.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 581 установка · ★ 89
- Автор: Netresearch DTT GmbH
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/netresearch/jira-skill/tree/HEAD/skills/jira-syntax/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/jira-syntax

## Что делает

\`jira-syntax` помогает агенту готовить текст именно под Jira wiki markup. Он заменяет Markdown-разметку на заголовки, списки, ссылки, таблицы, кодовые блоки и упоминания Jira. Также в комплекте есть шаблоны для баг-репортов и feature request с готовыми разделами.

Перед публикацией скилл запускает `scripts/validate-jira-syntax.sh` для проверки синтаксиса. Проверку нужно выполнять отдельным шагом, не объединяя её с командой публикации. Это важно: скрипт проверяет содержимое, но сам не отправляет его в Jira.

Для операций через API нужен отдельный скилл `jira-communication`. В остальных случаях достаточно передать агенту текст, путь к шаблону или файл для проверки.

## Требования
- Работает с: Jira

## Установка

### Claude Code (родная платформа)

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

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/jira-syntax/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/jira-syntax/

### Codex

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

2. **Вручную: положить файлы**
- Файл: `.agents/skills/jira-syntax/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/jira-syntax/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.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. **Командой платформы**
```bash
gemini skills install https://github.com/netresearch/jira-skill --path skills/jira-syntax
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/jira-syntax/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add netresearch/jira-skill --skill jira-syntax -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/netresearch/jira-skill/tree/HEAD/skills/jira-syntax/SKILL.md

## Когда брать
- перевести Markdown в разметку Jira
- оформить баг-репорт по шаблону
- собрать заявку на новую функцию
- проверить ссылки, таблицы и списки перед публикацией
- исправить ошибки в Jira wiki markup

## Примеры запросов агенту
- Преобразуй этот Markdown в разметку Jira для описания задачи.
- Оформи баг-репорт по шаблону `templates/bug-report-template.md`.
- Проверь файл `jira-comment.txt` скриптом в `scripts/validate-jira-syntax.sh` перед отправкой.

## Похожие
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [handoff](https://affpapa.org/nevibecode/skills/handoff.md) — скилл · 1038491 установка
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [domain-modeling](https://affpapa.org/nevibecode/skills/domain-modeling.md) — скилл · 876391 установка

Из того же набора: [netresearch/jira-skill](https://affpapa.org/nevibecode/by/netresearch/jira-skill.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md