prd-to-issues

Convert PRDs into dependency-aware Linear issue hierarchies with epics and stories.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Alfie728/my-skills --skill prd-to-issues-alfie728
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-to-issues
Source: https://github.com/Alfie728/my-skills/tree/main/prd-to-issues
Command: npx skills add https://github.com/Alfie728/my-skills --skill prd-to-issues-alfie728

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many product requirements documents (PRDs) remain high-level and unexecutable, causing ambiguity, duplicated effort, and poor parallelization across engineers and agents. This Skill provides a repeatable method to convert a PRD into a parent -> epic -> story hierarchy that is dependency-aware and ready for implementation. It enforces concrete file paths, acceptance criteria, and verification steps so work can be run in parallel or handed off to autonomous agents.

Core Features & Use Cases

  • Structured Breakdown: Drafts a parent issue, epics for workspaces, and granular stories with acceptance criteria and estimates.
  • Dependency-Aware Sequencing: Designs a clear DAG with workspace sequencing so teams can run independent workstreams without conflicts.
  • Implementation-Ready Stories: Each story references exact file paths, change instructions, patterns to follow, and verification steps for AFK execution.
  • Use Case: Convert an approved Linear project description or existing issue body into a set of Linear issues optimized for parallel agent execution and human review.

Quick Start

Break the approved PRD into a parent, epics, and stories optimized for Linear and present the proposed breakdown for user approval.

Frequently Asked Questions about prd-to-issues

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

FAQPage Schema
How do I convert a PRD into Linear issues for parallel execution?

Breaking down a PRD into Linear issues involves structuring work into a parent, epics, and stories with acceptance criteria and estimates. This Skill maps the hierarchy into dependency-aware DAGs with workspace sequencing, enabling parallel execution across engineers and agents.

What is a dependency-aware DAG for Linear issue hierarchies?

A dependency-aware DAG sequences Linear epics and stories so independent workstreams run without conflicts. It maps parent-to-child relationships and workspace ordering, allowing teams to parallelize implementation tickets safely across multiple agents or engineers.

Can I use existing Linear issue bodies or comments as input for PRD breakdown?

Yes, PRD breakdown can be applied to existing Linear issue bodies, comments, or project descriptions. The Skill extracts requirements from those sources and generates structured implementation tickets with story-level file paths and verification steps.

Does this PRD breakdown tool work with Linear CLI or MCP tools?

Yes, the Skill produces metadata compatible with Linear CLI or MCP tools. Each story includes file paths, change instructions, and verification steps formatted for direct ingestion, supporting automated workspace creation and issue import.

What's the best way to structure Linear stories for autonomous agent execution?

The best way is to give each Linear story exact file paths, change instructions, patterns to follow, and verification steps. This Skill enforces those implementation-ready attributes so work can be handed off to autonomous agents for AFK execution.

When do I need to break a PRD into epics and stories instead of single issues?

You need to break a PRD into epics and stories when work requires parallelization across multiple workspaces or agents. Single Linear issues lack the dependency-aware sequencing and granular acceptance criteria needed to prevent duplicated effort and conflicts.