jira-markup

name	jira-markup
description	Mandatory preprocessor for every Jira text write. ALWAYS use this skill immediately before creating, updating, replacing, or publishing any Jira text—including issue descriptions, comments, code-review results, research or architecture artifacts, checklists, and other wiki-rendered fields—even when formatting was not explicitly requested. Convert the final payload with scripts/converter.js before calling any Jira write tool. Do not use for read-only Jira operations.
argument-hint	<plain text, draft Jira field, links, files, code, table data, or formatting request>

Jira Markup

Required Workflow

When preparing text for Jira, always run the final text through scripts/converter.js. Do not hand-write Jira wiki markup directly unless the user explicitly asks for manual formatting.

How It Works

The script accepts Markdown text as input and writes the converted Jira Markup output to stdout.

Usage Examples

Examples assume the current directory is the skill root and Node.js is available.

Linux and macOS

printf "# Foo\n## Bar" | node ./scripts/converter.js

cat path/to/file.md | node ./scripts/converter.js

node ./scripts/converter.js $'# Foo\n## Bar'

Windows PowerShell

"# Foo`n## Bar" | node .\scripts\converter.js

Get-Content -Raw -Path .\path\to\file.md | node .\scripts\converter.js

node .\scripts\converter.js "# Foo`n## Bar"