Agent skill · mia-cx

prd-to-issues

Use when the user asks to break down a PRD into issues or create implementation tickets. Also use when writing a plan or roadmap based on a PRD to keep things traceable.

What it needs

About 4k tokens when loaded.

What this skill does

PRD to Issues Break a PRD into independently-grabbable GitHub issues using vertical slices (tracer bullets). Created issues are attached as sub-issues of the parent PRD issue with blocking relationships, so GitHub natively tracks completion and dependencies. Process 1. Locate the PRD Ask the user for the PRD issue number or URL. If it's not already in context, fetch it with gh issue view <number> (with comments). Explore the codebase if you haven't already. 2. Discover issue metadata Note what's available — issue types, labels, milestones, projects, assignees — and apply it when creating issues in step 5. When the org has issue types, they carry the type signal; labels don't double as types. 3. Draft vertical slices While exploring, look for opportunities to prefactor — "make the change easy, then make the easy change." Prefactoring slices come first and block the slices they ease. Each issue is a thin vertical slice cutting through ALL integration layers end-to-end, NOT a horizontal slice of one layer: Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests). A completed slice is demoable or verifiable on its own. Each slice is sized to fit in a single fresh context window. Prefer many thin slices over few thick ones. Slices are HITL (need human interaction — an architectural decision, a design review) or AFK (implementable and mergeable without one). Prefer AFK where possible. Wide refactors are the exception to vertical slicing. A wide refactor is one mechanical change — rename a column, retype a shared symbol — whose blast radius fans across the whole codebase, so a single edit breaks thousands of call sites and no vertical slice can land green. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills mia-cx/prd-to-issues

View the source on GitHub

Browse the @skills marketplace