Jira syntax

Skill netresearch/jira-skill/skills/jira-syntax

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.From its SKILL.md

Install

npx -y skills add netresearch/jira-skill --skill jira-syntax

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

What its file declares

Copied from the file, not written here

The file declares its own license as (MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.5 KB, 906 tokens by cl100k_base, as published. Nobody here has run it

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.txt

It 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 ${CLAUDE_SKILL_DIR}/scripts/validate-jira-syntax.sh
Submit via jira-communication skill

References

references/jira-syntax-quick-reference.md - Complete syntax documentation
references/cross-project-refs.md - GitLab cross-project ref convention (group/project!N, group/project#N, group/project@tag) when linking to GitLab from Jira
templates/bug-report-template.md - Bug report template
templates/feature-request-template.md - Feature request template
${CLAUDE_SKILL_DIR}/scripts/validate-jira-syntax.sh - Automated syntax checker
Official Jira Wiki Markup

What ships with it: 8 files

41.1 KB alongside SKILL.md, 1 of them executable