jira-syntax

Validate Jira wiki markup syntax with a Bash-based validation script.

73|21|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-syntax
Source: https://github.com/netresearch/jira-skill/tree/main/skills/jira-syntax
Command: npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides Jira wiki markup syntax validation, ready-to-use templates, and formatting guidance to ensure consistent content across Jira tickets, comments, and descriptions.

Core Features & Use Cases

  • Templates & references: Ready-made Jira templates (bug report, feature request) and a quick-reference for Jira syntax.
  • Syntax validation: Validate Jira wiki markup before submission to reduce back-and-forth.
  • Guidance for formatting: Clear rules for headings, code blocks, links, tables, panels, and more to ensure content renders correctly.

Quick Start

Use the validation script on a sample file:

  • scripts/validate-jira-syntax.sh templates/bug-report-template.md

Frequently Asked Questions about jira-syntax

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Jira wiki markup syntax before posting to issues?

Jira wiki markup validation checks formatting rules for headings, code blocks, links, tables, and panels before submission. Use the validation script on your content file to catch syntax errors and ensure correct rendering across Jira instances, reducing formatting corrections after posting.

What is Jira wiki markup and when do I need to use it?

Jira wiki markup is the formatting syntax for structuring content in Jira tickets, comments, and descriptions. You need it to format bug reports, feature requests, code blocks, and styled content consistently across your Jira instance without relying on rich-text editors.

Can I use ready-made templates for Jira bug reports and feature requests?

Yes, this Skill includes pre-built templates for bug reports and feature requests with correct Jira wiki markup already applied. Templates enforce consistent structure and formatting across your team's Jira tickets, reducing manual markup work.

How do I format headings, code blocks, and links correctly in Jira?

Jira wiki markup uses specific syntax for headings (h1–h6), code blocks (wrapped in {code}), and links ([text|URL]). The quick-reference guide provides exact formatting rules for these elements and other common structures like tables and panels.

Does this validation work across different Jira instances?

The validation script enforces standard Jira wiki markup syntax with cross-tool consistency checks, ensuring your formatted content renders correctly whether you're using Cloud or Server Jira instances with the same markup rules.