Skip to content
Development
Skill

/render

Render and validate Markdown content as Jira ADF with jirac before sending it to Jira as a description or comment

From plugin
jira-commands
4929 skills
Install
$ npx -y skills add mulhamna/jira-commands --skill render --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/render

Context preview

The summary Claude sees to decide when to auto-load this skill.

Render and validate Markdown content as Jira ADF with jirac before sending it to Jira as a description or comment

SKILL.md

render.SKILL.md
description: Render and validate Markdown content as Jira ADF with jirac before sending it to Jira as a description or comment

Preview how Markdown will convert to Atlassian Document Format (ADF) before posting it as a Jira issue description or comment.

Steps: 1. Check that `jirac` is available by running `jirac --version`. If missing, tell the user to install it (`cargo install jira-commands`). 2. Determine the input source:

  • File path: use `--input <path>`.
  • Inline content: pass via stdin (`echo '...' | jirac issue render`).

3. Run `jirac issue render --input file.md` (or stdin variant). 4. Show the rendered ADF preview. Highlight any nodes that may not render cleanly in Jira (unsupported HTML, raw images, complex tables). 5. If the result looks correct, the same content can be fed into `jirac issue update --description-file`, `jirac issue comment add --body-file`, or used in batch/bulk manifests.

Notes:

  • Useful when authoring rich descriptions with mentions, code blocks, lists, and tables — confirms conversion before going live.
  • Jira ADF supports a subset of Markdown: headings, bold/italic, code, lists, links, tables, blockquotes. Raw HTML is generally stripped.
  • For @mention preview, the rendered ADF will contain mention nodes when the source uses the `@username` syntax that the CLI recognizes.

Examples:

  • "preview this markdown before posting" → `jirac issue render --input draft.md`
  • "check if my description renders correctly" → `jirac issue render --input description.md`
Read more
Ships withjira-commands

Jira on the command line. jirac is a Jira command-line client written in Rust. It ships as a single binary with no runtime dependencies and runs on macOS, Linux, and Windows.

Get the whole plugin
Stats
49
Stars
14
Forks
Active
Maintenance
Rust
Language
7d ago
Last commit
5mo ago
Created

Repo: mulhamna/jira-commands

Other skills on jira-commands.