jira-syntax — Claude Code skill: what it does, how to install
This skill turns Markdown into Jira wiki markup, applies issue templates, and checks syntax before posting. Use it for Jira descriptions and comments.
npx skills add netresearch/jira-skill --skill jira-syntax -a claude-codeWhat jira-syntax does
jira-syntax prepares text for Jira’s wiki markup instead of Markdown. It covers headings, lists, links, tables, code blocks, issue links, and user mentions. The package also includes templates for bug reports and feature requests, with sections suited to each document type.
Before content is posted, run scripts/validate-jira-syntax.sh on the file. Validation must remain a separate step rather than being chained to the posting command. That matters because the script checks the markup; it does not submit the Jira content.
Use jira-communication for API actions. This skill is for authoring, formatting, templates, and syntax checks.
What it helps with
- convert Markdown into Jira wiki markup
- draft a bug report from the provided template
- structure a feature request with the right sections
- check links, tables, and lists before posting
- fix invalid Jira markup
Example prompts for the agent
- Convert this Markdown into Jira wiki markup for the issue description.
- Draft a bug report using
templates/bug-report-template.md. - Run the Jira syntax check on
jira-comment.txtbefore it is posted.
How to install jira-syntax
1Skills CLI (Vercel)
npx skills add netresearch/jira-skill --skill jira-syntax -a claude-code2Manually: put the files in place
~/.claude/skills/jira-syntax/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/jira-syntax/
1Skills CLI (Vercel)
npx skills add netresearch/jira-skill --skill jira-syntax -a codex2Manually: put the files in place
.agents/skills/jira-syntax/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add netresearch/jira-skill --skill jira-syntax -a cursor2Manually: put the files in place
.cursor/skills/jira-syntax/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install netresearch/jira-skill jira-syntax2Manually: put the files in place
.github/skills/jira-syntax/SKILL.md1Skills CLI (Vercel)
npx skills add netresearch/jira-skill --skill jira-syntax -a gemini-cli2Platform CLI
gemini skills install https://github.com/netresearch/jira-skill --path skills/jira-syntaxManually: put the files in place
.devin/skills/jira-syntax/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add netresearch/jira-skill --skill jira-syntax -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about jira-syntax
How do I install jira-syntax in Claude Code?
Run npx skills add netresearch/jira-skill --skill jira-syntax -a claude-code, then check ~/.claude/skills/jira-syntax/SKILL.md.
What does jira-syntax do?
It formats Markdown content as Jira wiki markup, provides bug and feature-request templates, and validates the result before posting.
Does jira-syntax send issues to Jira?
No. It handles authoring and validation. API operations belong to the jira-communication skill.
