Jira wiki markup syntax validation, templates, and formatting guidance. Use when: (1) Writing Jira issue descriptions or comments, (2) Converting Markdown to Jira wiki markup, (3) Requesting bug report or feature request templates, (4) Validating Jira syntax before submission, (5) Keywords like 'jira format', 'wiki markup', 'jira syntax', 'format for jira', (6) Ensuring content uses h2./h3. headings instead of Markdown ##, (7) Checking code blocks use {code:lang} not triple backticks, (8) Any task involving Jira text formatting
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
AGENTS.mdreferences/jira-syntax-quick-reference.mdscripts/validate-jira-syntax.shtemplates/bug-report-template.mdtemplates/feature-request-template.mdProvides Jira wiki markup syntax validation, templates, and formatting guidance. For API operations, use the jira-communication skill.
| 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| |
See references/jira-syntax-quick-reference.md for complete syntax documentation.
Path: templates/bug-report-template.md
Sections: Environment, Steps to Reproduce, Expected/Actual Behavior, Error Messages, Technical Notes
Path: templates/feature-request-template.md
Sections: Overview, User Stories, Acceptance Criteria, Technical Approach, Success Metrics
Run before submitting to Jira:
scripts/validate-jira-syntax.sh path/to/content.txt
h2. Title (space after period)*text* (single asterisk){code:language}...{code}* for bullets, # for numbers[label|url] or [PROJ-123]||Header|| and |Cell|{color:red}text{color}{panel:title=X}...{panel}| ❌ Wrong | ✅ Correct |
|---|---|
## Heading | h2. Heading |
**bold** | *bold* |
`code` | {{code}} |
[text](url) | [text|url] |
- bullet | * bullet |
h2.Title | h2. Title |
Workflow:
scripts/validate-jira-syntax.shuv run scripts/workflow/jira-create.py)references/jira-syntax-quick-reference.md - Complete syntax documentationtemplates/bug-report-template.md - Bug report templatetemplates/feature-request-template.md - Feature request templatescripts/validate-jira-syntax.sh - Automated syntax checker