SkillsAdd

netresearch/jira-skill

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.

First seen Feb 3, 2026

Installation

$ npx skills add netresearch/jira-skill --skill jira-syntax
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

n8n-expression-syntax Similar name
czlonkowski/n8n-skills

Validate n8n expression syntax and fix common errors. Use when writing n8n expressions, using {…

5.8K installs
mojo-syntax Similar name
modular/skills

Help to write Mojo code using current syntax and conventions.

2.3K installs
filter-syntax Similar name
dotnet/skills

Reference-only filter syntax for VSTest and MTP with MSTest, NUnit, xUnit v3, and TUnit. Load o…

2.2K installs
arkts-syntax-assistant Similar name
summerkaze/skill-arkts-syntax-assistant

ArkTS syntax, migration, and optimization guide for HarmonyOS/OpenHarmony development. Triggers…

806 installs
mermaid-syntax Similar name
awesome-skills/mermaid-syntax-skill

This skill should be used when the user asks to "create a mermaid diagram", "fix mermaid error"…

247 installs
modern-move-syntax Similar name
mystenlabs/skills

Use when writing Move code on Sui to ensure 2024 edition syntax is used. Applies to method call…

243 installs

Also in this package

Other skills from netresearch/jira-skill.

npx skills add netresearch/jira-skill
jira-communication 455 jira-integration 1

Browse all from netresearch/jira-skill

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 80
License LICENSE-CC-BY-SA-4.0
Default branch main
Open issues 3
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version3.30.1
License(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0
More metadata
author
Netresearch DTT GmbH
version
3.30.1
repository
https://github.com/netresearch/jira-skill

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,621 B
  • docs AGENTS.md 1,801 B
  • docs SUMMARY.md 281 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 470 installs

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

  1. Get template from jira-syntax
  2. Fill content using Jira wiki markup
  3. Validate with ${CLAUDESKILLDIR}/scripts/validate-jira-syntax.sh
  4. 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
  • ${CLAUDESKILLDIR}/scripts/validate-jira-syntax.sh - Automated syntax checker
  • Official Jira Wiki Markup