jira-integration_skill

Overview

This skill provides Jira wiki markup syntax validation, ready-to-use templates, and practical formatting guidance for writing issue descriptions and comments. It helps convert Markdown to Jira wiki markup, enforces Jira-specific conventions (headings, code blocks, lists, tables), and includes quick references and templates for bug reports and feature requests.

How this skill works

The skill inspects text for common Markdown-to-Jira mistakes and validates Jira wiki constructs (headings, bold/italic, code blocks, lists, links, tables, panels, colors). It offers templates you can fill and a validation checklist and script to run locally before submission. Use the guidance to convert triple-backtick code blocks to {code:lang} and Markdown headings to h2./h3. formats.

When to use it

• Writing Jira issue descriptions or comments and ensuring they render correctly
• Converting Markdown content (README, PR notes) into Jira wiki markup
• Preparing bug reports or feature requests using provided templates
• Validating Jira syntax before creating or updating issues
• Checking code blocks, headings, lists, links, and tables follow Jira markup

Best practices

• Use h2. and h3. with a space after the period instead of Markdown ##/###
• Wrap code blocks with {code:language}...{code} and inline code with {{code}}
• Prefer *bold* and _italic_ Jira forms rather than Markdown asterisks or underscores
• Format links as [label|url] and reference issues as [PROJ-123]
• Run the provided validation script before submitting to catch common mistakes

Example use cases

• Convert a Markdown release note into Jira wiki markup for a release ticket
• Fill the bug report template with Environment, Steps to Reproduce, and Error Messages
• Create a feature request using the feature template: Overview, User Stories, Acceptance Criteria
• Validate and fix formatting issues in a long technical comment (tables, panels, colors)
• Ensure code samples in an issue use language-tagged {code:java} blocks for proper rendering