prd-to-issues

Break PRDs into GitHub sub-issues with blocking relationships via gh CLI.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/mia-cx/.agents --skill prd-to-issues-mia-cx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-to-issues
Source: https://github.com/mia-cx/.agents/tree/main/skills/prd-to-issues
Command: npx skills add https://github.com/mia-cx/.agents --skill prd-to-issues-mia-cx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Created issues are attached as GitHub sub-issues of the parent PRD issue with blocking relationships for native tracking, planning, and dependency visualization.

Core Features & Use Cases

  • Break PRDs into tracer-bullet issues that cover end-to-end flow across all layers.
  • Automatically attach new issues as sub-issues of the parent PRD and establish blocking relationships.
  • Draft metadata (labels, milestones, projects, assignees) for each slice to streamline creation and tracking.

Quick Start

Provide the PRD GitHub issue number or URL and let the skill generate tracer-bullet issues as GitHub sub-issues with blocking relationships.

Frequently Asked Questions about prd-to-issues

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

FAQPage Schema
How do I break a PRD into actionable GitHub issues?

To break a PRD into actionable GitHub issues, provide the PRD's GitHub issue number or URL. The system decomposes the document into independent, end-to-end tracer-bullet vertical slices and creates them as native GitHub sub-issues.

What are tracer-bullet vertical slices in project management?

Tracer-bullet vertical slices are independently-grabbable work items that cover an end-to-end flow across all architectural layers. They ensure each issue delivers functionality spanning the entire stack rather than focusing on a single horizontal layer.

Do I need the gh CLI to automate GitHub issue creation from a PRD?

Yes, you need the gh CLI to automate GitHub issue creation from a PRD. It requires available GitHub access and the gh CLI to perform issue operations, establish blocking relationships, and attach new items as sub-issues.

Can I track PRD dependencies natively in GitHub issues?

Yes, you can track PRD dependencies natively in GitHub issues. Created sub-issues are attached to the parent PRD issue with blocking relationships, enabling native tracking, clear dependency visualization, and streamlined planning.

How to organize milestones and labels when splitting a PRD into issues?

When splitting a PRD into issues, the system automatically drafts metadata for each slice. It assigns labels, milestones, projects, and assignees to streamline the creation process and ensure consistent project management tracking.

What is the best way to decompose a PRD for a development team?

The best way to decompose a PRD for a development team is using tracer-bullet vertical slices. This approach validates blockers and dependencies prior to creation, producing independently grabbable GitHub issues that span end-to-end flows.