mp-to-issues

Break a PRD GitHub issue into labeled vertical-slice sub-issues with blocking relationships.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-to-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-to-issues
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-to-issues
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-to-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It converts a single PRD GitHub issue into a set of vertical-slice sub-issues with clear dependencies, labels, and approval gates so teams can implement incrementally without losing traceability.

Core Features & Use Cases

  • Vertical-slice decomposition: Splits a PRD issue into independently implementable slices (not horizontal layers) that map back to PRD requirements.
  • HITL/AFK governance: Classifies sub-issues using labels only (HITL for unanswered decisions, AFK for fully defined work).
  • Native GitHub linking: Links each sub-issue to the PRD using the addSubIssue GraphQL mutation and uses gh CLI for GitHub operations.
  • Clarification-first guardrails: Fetches the issue body and comments, resolves ambiguities, and grills the user for decisions before creating issues.

Quick Start

Use mp-to-issues with the PRD issue URL or number to produce an approved, labeled vertical-slice breakdown with correct blocking relationships before any sub-issues are created.

Frequently Asked Questions about mp-to-issues

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

FAQPage Schema
How do I break a PRD GitHub issue into vertical-slice sub-tasks?

To break a PRD GitHub issue into vertical-slice sub-tasks, use a skill that fetches the issue via gh CLI, asks you to resolve ambiguities, designs 3–15 testable slices mapped to requirements, and links them using the addSubIssue GraphQL mutation.

Can I link sub-issues to a parent PRD issue natively in GitHub?

Yes, you can link sub-issues to a parent PRD issue natively by executing the addSubIssue GraphQL mutation, which establishes correct blocking relationships between the newly created vertical slices and the original requirement.

What is the best way to handle unresolved decisions before creating GitHub issues?

The best way to handle unresolved decisions before creating GitHub issues is to fetch the issue comments first, identify open questions, and require the user to resolve ambiguities through HITL (Human-in-the-Loop) labeling before generating any sub-tasks.

Does generating vertical slice sub-issues from a PRD require gh CLI?

Generating vertical slice sub-issues from a PRD requires gh CLI to fetch the issue body, comments, and node ID, ensuring dependencies and HITL/AFK labels are applied correctly before using GraphQL to link the sub-issues.

How many vertical slices should I create from a single PRD issue?

You should create 3 to 15 vertical slices from a single PRD issue, ensuring each slice is independently implementable, maps directly to a PRD requirement, and is labeled correctly as HITL or AFK for governance.

When should I not use automated vertical slicing for GitHub issues?

You should not use automated vertical slicing for GitHub issues when prior comments contain decisions or ambiguities that remain unresolved, as the workflow requires user clarification before it can safely design and create testable sub-tasks.