jira-write-ticket

Generate Jira ticket descriptions and acceptance criteria in Markdown.

11|2|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/bkircher/skills --skill jira-write-ticket
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-write-ticket
Source: https://github.com/bkircher/skills/tree/main/jira-write-ticket
Command: npx skills add https://github.com/bkircher/skills --skill jira-write-ticket

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the creation of Jira tickets by ensuring all necessary information is present and well-formatted, reducing back-and-forth for clarifications.

Core Features & Use Cases

  • Structured Ticket Generation: Creates ticket descriptions and acceptance criteria in a standardized Markdown format.
  • Clarification Prompts: Identifies missing information and asks targeted questions.
  • Code Linking: Converts code references to GitHub permalinks for better context.
  • Jira Ticket Summarization: Integrates with jira-read-ticket to include summaries of linked tickets.
  • Use Case: When you need to create a new Jira ticket for a bug fix, this Skill will help you draft a clear description and actionable acceptance criteria, prompting you for any missing details.

Quick Start

Use the jira-write-ticket skill to draft a new Jira ticket for the bug described in the provided context.

Frequently Asked Questions about jira-write-ticket

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

FAQPage Schema
How do I write a Jira ticket with clear acceptance criteria and description?

To write a Jira ticket with clear acceptance criteria, you need a structured Markdown template that separates the description, links, and acceptance criteria sections. This ensures all necessary information is present and well-formatted, reducing clarification requests.

What's the best way to format bug tracking tickets to avoid missing information?

The best way to format bug tracking tickets is using a standardized Markdown format that prompts for missing details. This approach identifies gaps in your ticket description and asks targeted questions to ensure complete documentation before submission.

Can I link GitHub code references directly in my Jira ticket documentation?

Yes, you can link GitHub code references in Jira ticket documentation. The process converts standard code locations into GitHub permalinks, providing better context for developers directly within the ticket's Links section.

How do I include summaries of referenced Jira tickets in a new ticket creation?

To include summaries of referenced Jira tickets during new ticket creation, the process integrates with a ticket reading skill that extracts and summarizes linked ticket information. This provides immediate context within your new ticket's Links section.

Do I need Markdown to create Jira tickets with this standardized approach?

Yes, Markdown is required to create Jira tickets with this approach. The output strictly adheres to a predefined Markdown template containing Description, Links, and Acceptance Criteria sections, ensuring consistent formatting across all generated tickets.

What should I do if my Jira ticket description is missing required details?

When your Jira ticket description is missing required details, the system identifies the gaps and prompts you with targeted clarification questions. This ensures all necessary information is collected and clearly articulated before finalizing the ticket.