write-a-prd

Generate a GitHub-issue PRD from user interviews and repository exploration.

12|Updated Dec 25, 2024
One-click install
npx skills add https://github.com/whyte25/reusables --skill write-a-prd-whyte25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/whyte25/reusables/tree/main/.agents/skills/write-a-prd
Command: npx skills add https://github.com/whyte25/reusables --skill write-a-prd-whyte25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you transform a rough idea or feature request into a well-structured PRD by aligning you with users through interviews, validating assumptions against the current codebase, and designing the modules needed for implementation.

Core Features & Use Cases

  • User interview-driven requirements: Elicits a shared understanding by questioning every assumption and decision path until details are resolved.
  • Repo-aware planning: Explores the existing codebase to verify claims and understand what already exists before specifying changes.
  • Module-first design: Breaks the work into major modules, emphasizing deeper, testable interfaces and confirming what you want tested.
  • PRD delivered as a GitHub issue: Produces a comprehensive PRD that includes problem/solution, extensive user stories, implementation and testing decisions, and clear out-of-scope items.

Quick Start

Ask the skill to write a PRD for your feature by providing a long, detailed description of the problem you want to solve and any initial solution ideas.

Frequently Asked Questions about write-a-prd

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

FAQPage Schema
How do I turn user interviews into a product requirements document?

You convert user interviews into a product requirements document by systematically questioning assumptions and decision paths until details are resolved, producing a clear problem and solution statement. This process ensures a shared understanding of the requirements.

What is the best way to write a PRD for a major module refactor?

The best way to write a PRD for a major module refactor is to explore the existing codebase to verify claims and design testable module-level interfaces. This approach clarifies implementation decisions and confirms exactly what needs to be tested.

Can I generate a GitHub issue directly from a feature plan?

Yes, you can generate a GitHub issue directly from a feature plan by structuring finalized requirements into an implementation-oriented submission. This issue includes user stories, testing decisions, and clear out-of-scope items.

How to structure testing decisions within a PRD?

To structure testing decisions within a PRD, break the work into major modules and explicitly confirm what you want tested for each interface. This ensures testing requirements are defined alongside implementation decisions.

Does repo exploration help validate product requirements before implementation?

Yes, repo exploration helps validate product requirements by checking the current codebase to understand what already exists before specifying changes. This prevents duplicate work and ensures new modules align with existing dependencies.

What should be included in out-of-scope items for a feature PRD?

Out-of-scope items in a feature PRD should include functionalities and design paths intentionally excluded from the current implementation phase. Defining these boundaries prevents scope creep and sets clear expectations for developers.