markdown-to-jira

Convert structured Markdown backlog blocks into Jira epics and tasks.

1|Updated Dec 9, 2024
One-click install
npx skills add https://github.com/hadenlabs/tasks --skill markdown-to-jira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-jira
Source: https://github.com/hadenlabs/tasks/tree/main/.claude/skills/markdown-to-jira
Command: npx skills add https://github.com/hadenlabs/tasks --skill markdown-to-jira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually converting Markdown backlog blocks into Jira epics and tasks is error-prone and time-consuming; this skill automates the end-to-end workflow and updates the source Markdown with real Jira keys.

Core Features & Use Cases

  • Read and identify Epic and Task blocks from a structured Markdown document.
  • Validate required metadata (projectKey, issueType, summary, description, component, labels).
  • Create an Epic first (if present), then Tasks, linking them as needed.
  • Apply labels and components via jira_editJiraIssue, and write real issue keys back into the document.
  • Supports Context Queries to augment the description when present in the block.

Quick Start

Provide a Markdown document containing Epic and/or Task blocks to automatically create Jira issues and update the document with real keys.

Frequently Asked Questions about markdown-to-jira

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

FAQPage Schema
How do I convert a Markdown backlog into Jira epics and tasks?

This conversion works by reading structured Markdown backlog blocks containing required metadata like projectKey, issueType, summary, description, component, and labels. It validates the data, creates an Epic first if present, then generates Tasks, and writes real Jira issue keys back into the document.

What is the required Markdown format for creating Jira issues from a backlog?

The required format uses structured Epic and Task blocks within a Markdown document. Each block must contain specific metadata fields: projectKey, issueType, summary, description, component, and labels, to pass validation and successfully generate Jira issues.

Does the Markdown to Jira conversion process support linking tasks to epics?

Yes, the conversion process supports linking tasks to epics. It automatically creates the Epic first if present in the Markdown document, then creates the Tasks and applies optional epic linkage between them via the jira_editJiraIssue function.

Can I apply Jira labels and components when generating issues from Markdown?

Yes, you can apply Jira labels and components when generating issues from Markdown. The process validates these fields within the Markdown blocks and applies them to the newly created Jira issues using the jira_editJiraIssue function.

How does the system handle missing metadata in Markdown backlog blocks?

The system validates required metadata fields like projectKey, issueType, summary, description, component, and labels within Markdown backlog blocks. It enforces this metadata before creation, ensuring blocks lacking the required information do not proceed to Jira issue generation.

Are context queries supported when creating Jira tasks from Markdown?

Yes, context queries are supported when creating Jira tasks from Markdown. The system processes context queries present in the structured Markdown block to augment and enhance the generated Jira issue description.