jira-writer

Create and update Jira tickets via REST API with Markdown-to-ADF conversion.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/yunidbauza/jira-writer --skill jira-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-writer
Source: https://github.com/yunidbauza/jira-writer/tree/main/plugins/jira-writer/skills/jira-writer
Command: npx skills add https://github.com/yunidbauza/jira-writer --skill jira-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, mmdc, base64, and includes scripts (resource) components.

What problem does it solve?

Jira ticket management often requires composing rich descriptions, embedding diagrams, and tracking changes across multiple issues. This skill streamlines creating and updating Jira Cloud tickets with markdown-to-ADF conversion and automatic Mermaid diagrams embedding.

Core Features & Use Cases

  • Create new Jira tickets with structured content and optional Mermaid diagrams
  • Update existing ticket descriptions with append, insert, or replace operations
  • Parse Markdown files and convert to Jira's Atlassian Document Format (ADF)
  • Convert Mermaid diagrams to PNGs and embed them as attachments in descriptions
  • Support batch processing for multiple diagrams or content blocks in a single request

Quick Start

Ask me to create or update a Jira ticket by providing the content file or Markdown with Mermaid diagrams to embed.

Frequently Asked Questions about jira-writer

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

FAQPage Schema
How do I convert Markdown to Atlassian Document Format for Jira tickets?

To convert Markdown to Atlassian Document Format (ADF) for Jira tickets, this skill parses Markdown content and translates it into ADF using the REST API. It structures rich text descriptions and acceptance criteria checklists for Jira Cloud issues.

Can I embed Mermaid diagrams in Jira ticket descriptions?

Yes, you can embed Mermaid diagrams in Jira ticket descriptions. The skill converts Mermaid syntax to PNG images using mmdc, uploads them as attachments via the REST API, and inserts the image references into the ADF content.

How do I append or replace content in an existing Jira ticket description?

To append or replace content in an existing Jira ticket, the skill supports insert, append, and replace update operations via the Jira REST API. This allows targeted modifications to ADF descriptions without overwriting the entire ticket.

Do I need curl and jq to automate Jira ticket creation?

Yes, you need curl and jq installed to automate Jira ticket creation and updates. The skill also requires mmdc for Mermaid diagram conversion to PNG and base64 for encoding attachments during the REST API interactions.

What is the best way to automate batch Jira ticket updates with rich content?

The best way to automate batch Jira ticket updates is using this skill to process multiple content blocks or diagrams in a single request. It validates credentials, handles Markdown-to-ADF conversion, and manages attachment uploads with robust error handling.

Why does Jira ticket creation fail when embedding Mermaid diagrams via REST API?

Jira ticket creation fails when embedding Mermaid diagrams if the mmdc dependency is missing or credentials are invalid. The skill validates Jira credentials and handles diagram conversion errors during the attachment upload process to prevent failures.