Use when writing or formatting Jira descriptions, comments, or any text destined for Jira. Converts Markdown to Jira wiki markup, provides templates (bug reports, feature requests), and validates syntax before submission. Trigger on any Jira content authoring task.
Jira wiki markup syntax, templates, and validation. 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:
${CLAUDE_SKILL_DIR}/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:
${CLAUDE_SKILL_DIR}/scripts/validate-jira-syntax.shreferences/jira-syntax-quick-reference.md - Complete syntax documentationtemplates/bug-report-template.md - Bug report templatetemplates/feature-request-template.md - Feature request template${CLAUDE_SKILL_DIR}/scripts/validate-jira-syntax.sh - Automated syntax checker