generate-issue-tickets

Generate structured issue ticket markdown files with validated frontmatter in a ticket workspace.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/hpark0011/mirror --skill generate-issue-tickets-hpark0011
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-issue-tickets
Source: https://github.com/hpark0011/mirror/tree/main/.agents/skills/generate-issue-tickets
Command: npx skills add https://github.com/hpark0011/mirror --skill generate-issue-tickets-hpark0011

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Turning bugs, feature requests, and plans into trackable work items often produces inconsistent, vague tickets. This Skill enforces a strict frontmatter contract and body structure so every issue ticket is complete, prioritized, and machine-validatable. ## Core Features & Use Cases - Structured Ticket Generation: Creates markdown tickets in workspace/tickets/to-do with required fields like id, type, priority, dependencies, and acceptance criteria. - Automatic Validation: A PostToolUse hook runs a Node.js validator that checks frontmatter fields, required body sections, filename conventions, directory-status sync, duplicate IDs, and circular dependencies. - Priority and Type Rubrics: Built-in p0-p3 priority rubric and seven ticket types (feature, fix, improvement, chore, docs, refactor, perf) keep triage consistent. - Use Case: After a code review reveals an unauthenticated admin API route, ask the agent to file a ticket and receive a validated FG_001-p1 ticket with deterministic acceptance criteria and implementation steps. ## Quick Start Ask the agent to create a ticket for the bug or feature you describe, or say "break down this plan into tickets" to generate multiple validated issue tickets.

Frequently Asked Questions about generate-issue-tickets

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

FAQPage Schema
How do I create an issue ticket from a bug report?▼

Describe the bug to the agent and it investigates the codebase, assigns the next FG_NNN id, picks a priority using the p0-p3 rubric, and writes a validated markdown ticket to workspace/tickets/to-do. A hook automatically validates the file after it is written.

How do I break down a plan into multiple tickets?▼

Ask the agent to break down the plan. It scans existing tickets once, assigns sequential FG_NNN ids upfront, writes all ticket files, validates them together, and reports a summary table with dependencies between tickets.

What fields are required in the ticket frontmatter?▼

Required fields are id (FG_NNN format), title (max 80 chars), date, type, status, priority, description (min 10 words), dependencies, acceptance_criteria (2-7 items), and owner_agent. The validator rejects files missing any required field.

Does the ticket validator check dependencies between tickets?▼

Yes. When validating multiple files, the validator checks for duplicate ids, verifies that referenced dependency ids exist, and runs cycle detection to catch circular dependencies between tickets.

Why does ticket validation fail after moving a file?▼

Ticket status is encoded in both the frontmatter status field and the directory name. Moving a file from to-do to completed without updating the status field causes a directory-status mismatch error. Update both together.