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
5429 skills

Claude Code

$ npx -y skills add mulhamna/jira-commands --skill render --agent claude-code

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 Markdown file can be sent with `jirac issue update <KEY> --description-file file.md` or `jirac issue comment <KEY> add --file file.md`, 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
@mulhamna
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.

Stars on GitHub

Momentum

stars in total
54
Star history of mulhamna/jira-commands on GitHub, a chart by star-history.com

Other skills on jira-commands.

api

api

Execute a raw Jira REST API call through the jirac CLI, including GET, POST, PUT, DELETE, and PATCH requests to any Jira REST…

batch

batch

Run mixed Jira operations (create, update, transition, archive) from a single JSON manifest file using jirac batch

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc12d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react2d252k
@facebook@facebookInstall Skill

Questions about render.

Which coding agents can use render?
render installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.