write-a-prd

Create detailed PRDs from problem descriptions, codebase exploration, and structured interviews.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/mappa-ai/skills --skill write-a-prd-mappa-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/mappa-ai/skills/tree/main/utils-skills/write-a-prd
Command: npx skills add https://github.com/mappa-ai/skills --skill write-a-prd-mappa-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a durable PRD by combining problem discovery, repo context, and relentless structured interviews to align teams before implementation.

Core Features & Use Cases

  • Guided problem discovery through interviews to capture scope and acceptance criteria
  • Codebase exploration to ground requirements in the current project state
  • Generates plans/prd-name.md using the fixed PRD template with extensive user stories, decisions, and notes

Quick Start

Ask for a detailed problem description, explore the repository to ground assertions, interview until alignment, then write plans/prd-name.md using the PRD 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 write a PRD that captures user stories and implementation decisions from a codebase?

To write a PRD grounded in your codebase, provide a problem description for repository exploration. The skill conducts structured interviews to extract user stories and implementation decisions, then outputs a durable PRD markdown file.

What is the best way to align teams on product requirements before starting implementation?

Aligning teams on product requirements requires relentless structured interviews to capture scope and acceptance criteria. Combining problem discovery with codebase context ensures the generated PRD reflects actual project state and decisions.

How to generate user stories and scope for a platform improvement PRD?

Generating user stories and scope for a platform improvement PRD involves guided problem discovery through interviews. The skill explores your repo to ground assertions, capturing extensive user stories, implementation decisions, and notes in a fixed template.

Does this PRD generation process require a specific template or output format?

The PRD generation process uses a fixed template and writes the output directly to a markdown file named plans/prd-name.md. This ensures the problem, solution, user stories, implementation decisions, scope, and notes follow a consistent format.

Can I use this approach to draft requirements for features across existing software projects?

Yes, you can draft requirements for features across existing software projects. The skill explores your repository to ground assertions in the current project state before guiding problem statements and writing the final PRD.

What limitations exist when creating a PRD through automated repo exploration and interviews?

A limitation of creating a PRD through automated repo exploration is dependency on the accuracy of your initial problem description. The skill requires continuous interview interaction until alignment is reached before writing the final markdown output.