SKILL.md
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\ | ` |
See references/jira-syntax-quick-reference.md for complete syntax documentation.
Available Templates
Bug Report
Path: templates/bug-report-template.md
Sections: Environment, Steps to Reproduce, Expected/Actual Behavior, Error Messages, Technical Notes
Feature Request
Path: templates/feature-request-template.md
Sections: Overview, User Stories, Acceptance Criteria, Technical Approach, Success Metrics
Syntax Validation
Run before submitting to Jira:
${CLAUDE_SKILL_DIR}/scripts/validate-jira-syntax.sh path/to/content.txtIt gates the post — run it as its own step, never chained with the posting command.
Validation Checklist
- Headings:
h2. Title(space after period) - Bold:
text(single asterisk) - Code blocks:
{code:language}...{code} - Lists:
*for bullets,#for numbers - Links:
[label|url]or[PROJ-123] - Tables:
||Header||and|Cell| - Colors:
{color:red}text{color} - Panels:
{panel:title=X}...{panel}
Common Mistakes
| ❌ Wrong | ✅ Correct | |
|---|---|---|
## Heading |
h2. Heading |
|
bold |
bold |
|
` code ` |
{{code}} |
|
[text](url) |
`[text\ | url]` |
- bullet |
* bullet |
|
h2.Title |
h2. Title |
|
MR !42 (bare GitLab ref) |
`[MR 42\ | url] or full group/project!42 — a bare !…!` is image markup |
(/) on an open/proposed item |
(x) — (/) renders as a green check (done); use (x) for open items |
|
( ) as a checkbox |
(x) — ( ) is not a macro and renders literally |
Integration with jira-communication Skill
Workflow:
- Get template from jira-syntax
- Fill content using Jira wiki markup
- Validate with
${CLAUDESKILLDIR}/scripts/validate-jira-syntax.sh - Submit via jira-communication skill
References
references/jira-syntax-quick-reference.md- Complete syntax documentationreferences/cross-project-refs.md- GitLab cross-project ref convention (group/project!N,group/project#N,group/project@tag) when linking to GitLab from Jiratemplates/bug-report-template.md- Bug report templatetemplates/feature-request-template.md- Feature request template${CLAUDESKILLDIR}/scripts/validate-jira-syntax.sh- Automated syntax checker- Official Jira Wiki Markup