custom-jira-ticket-management

Creates and links Jira tickets via jira-cli with decomposition rules and description templates.

1|Updated Apr 3, 2021
One-click install
npx skills add https://github.com/NaoyaMiyagawa/dotfiles --skill custom-jira-ticket-management-naoyamiyagawa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: custom-jira-ticket-management
Source: https://github.com/NaoyaMiyagawa/dotfiles/tree/main/.ai/skills/custom-jira-ticket-management
Command: npx skills add https://github.com/NaoyaMiyagawa/dotfiles --skill custom-jira-ticket-management-naoyamiyagawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature or project into well-scoped Jira tickets is slow and error-prone: tickets end up too big, vaguely described, missing acceptance criteria, or disconnected from related work. This Skill structures the entire ticket-writing workflow so every ticket is independently deliverable and understandable by a teammate with zero conversation context. ## Core Features & Use Cases - Work Decomposition: Slices features and epics into right-sized, vertically-cut tickets (roughly one PR each), with spike tickets for blocking unknowns. - Structured Ticket Creation: Drafts summaries and markdown descriptions (Why, What, Out of scope, Acceptance criteria, References), gets your approval, then creates tickets with jira-cli using -T body files to avoid shell-quoting issues. - Issue Linking: Establishes parent/epic membership, Blocks ordering between siblings, and Relates links back to origin tickets. - Use Case: You describe a new webhook feature; the Skill breaks it into an epic with three child tasks, drafts each description with checkable acceptance criteria, confirms the plan with you, then creates and links everything in Jira. ## Quick Start Break this feature down into Jira tickets and create them with jira-cli after I approve the drafts.

Frequently Asked Questions about custom-jira-ticket-management

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

FAQPage Schema
How do I create Jira tickets from the command line?

Use jira-cli with `jira issue create -t Task -s "Summary" -T body.md --no-input`, where the description is written to a file and passed with -T to avoid shell-quoting problems. Add -P EPIC-KEY to attach the ticket to a parent epic.

How to break a feature or epic into Jira tickets?

Slice the work vertically so each ticket is one independently deliverable, verifiable outcome, roughly one PR. If a ticket's status needs more than a sentence to describe, split it; blocking unknowns become timeboxed spike tickets.

How do I link Jira issues with jira-cli?

Run `jira issue link KEY-1 KEY-2 Blocks` after both tickets exist. Link types vary per Jira instance, so if a type is rejected, list the valid ones instead of guessing synonyms.

What should a good Jira ticket description include?

Include Why (problem and source links), What (concrete changes), Out of scope, checkable Acceptance criteria, and References. Write for a reader with no conversation context, spelling out acronyms and linking source material.

Why does jira-cli ticket creation fail with auth errors?

Creation fails when jira-cli is not authenticated or configured for your Jira instance. The Skill reports the failure and stops; setup and authentication steps are covered by the companion context-fetching skill.