write-a-prd

Interview users and analyze codebases to generate structured PRDs.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/raphaelmans/agent-skills --skill write-a-prd-raphaelmans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/raphaelmans/agent-skills/tree/main/write-a-prd
Command: npx skills add https://github.com/raphaelmans/agent-skills --skill write-a-prd-raphaelmans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams transform user interviews, codebase insights, and design considerations into a structured PRD that can be submitted as a GitHub issue.

Core Features & Use Cases

  • Guided discovery: asks for a long, detailed problem description and clarifying questions to reach shared understanding.
  • Context exploration: analyzes the repository to validate assumptions and gather scope.
  • Structured interviewing: conducts iterative interviews to resolve dependencies and design trade-offs.
  • Modular design sketching: outlines major modules and design choices to enable testable isolation.
  • PRD generation: produces a complete PRD using the standard template and prepares a GitHub issue.

Quick Start

Provide a long, detailed problem description and I will generate a PRD using the template.

Frequently Asked Questions about write-a-prd

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

FAQPage Schema
How do I convert user research into a structured product requirement document?

To convert user research into a product requirement document, provide a detailed problem description to trigger a guided interview that validates assumptions against your codebase and generates a PRD with problem statements, user stories, and implementation decisions.

What sections are needed when I write a PRD for a new software feature?

When you write a PRD for a new software feature, required sections include a Problem Statement, Solution, User Stories, Implementation Decisions, Testing Decisions, Out of Scope, and Further Notes to ensure complete module design coverage.

Can I generate a GitHub issue directly from a feature planning interview?

Yes, you can generate a GitHub issue directly from a feature planning interview by completing the iterative discovery process, which outlines major modules and automatically formats the structured PRD output for repository submission.

How do I plan modular architecture during product development kick-off?

To plan modular architecture during product development kick-off, the system analyzes your repository context to validate scope and sketches major modules with specific design choices, enabling testable isolation before finalizing the requirement document.

What is the best way to outline implementation decisions for a requirement document?

The best way to outline implementation decisions for a requirement document is through structured interviewing that resolves dependencies and evaluates design trade-offs, ensuring all technical choices are documented alongside user stories.

Does feature planning require a detailed problem description before writing a PRD?

Feature planning requires a long, detailed problem description before writing a PRD to reach a shared understanding, which then drives clarifying questions and context exploration to accurately define the product scope.