Jira Syntax

If you work with Jira and are tired of manually converting Markdown to wiki markup, this handles the translation and gives you pre-built templates for bug reports and feature requests. It includes a validation script to catch common mistakes before you submit, which is genuinely useful since Jira's syntax is just different enough from Markdown to trip you up (single asterisks for bold, h2. with a space, pipes and brackets everywhere). The quick reference table is handy to keep open while drafting. Pairs with their jira-communication skill if you need API operations, but this one is purely about getting the markup right.

skills.sh installs: 596
GitHub stars: 90
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add netresearch/jira-skill --skill jira-syntax --agent claude-code

Installs into .claude/skills of the current project.

Files

Jira Syntax

Jira wiki markup syntax, templates, and validation. For API operations, use the jira-communication skill.

Quick Syntax Reference

Jira Syntax	Purpose	NOT this (Markdown)
`h2. Title`	Heading	`## Title`
`bold`	Bold	`bold`
`_italic_`	Italic	`italic`
`{{code}}`	Inline code	`code`
`{code:java}...{code}`	Code block	java ```
`[text\|url]`	Link	`[text](url)`
`[PROJ-123]`	Issue link	-
`[~username]`	User mention	`@username`
`* item`	Bullet list	`- item`
`# item`	Numbered list	`1. item`
`\|\|Header\|\|`	Table header	`\|Header\|`