write-a-prd

Generate a structured PRD JSON file from a problem description.

Updated Oct 30, 2025
One-click install
npx skills add https://github.com/finleysg/bhmc-admin --skill write-a-prd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/finleysg/bhmc-admin/tree/main/.claude/skills/write-a-prd
Command: npx skills add https://github.com/finleysg/bhmc-admin --skill write-a-prd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams turn vague feature ideas into a detailed PRD, reducing ambiguity and misalignment across stakeholders. It guides you through problem framing, scope definition, success criteria, milestones, risks, and validation plans so everyone shares a single vision.

Core Features & Use Cases

  • PRD generation from user input: transforms a narrative into a structured PRD with sections like Objective, Problem Statement, Scope, Success Criteria, Metrics, Milestones, Risks, and Assumptions.
  • Guided clarifying questions: prompts for missing details (problem statement, constraints, user stories, acceptance criteria) to ensure a complete PRD.
  • Output & traceability: writes the PRD to the /plans directory as a JSON file using the standard template and includes versioning metadata for change tracking.

Quick Start

Create a PRD for a feature by providing a detailed problem statement, scope, goals, and acceptance criteria. The skill will generate a PRD JSON and place it in the /plans directory.

Frequently Asked Questions about write-a-prd

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

FAQPage Schema
How do I create a PRD from a feature idea?

To create a PRD from a feature idea, provide a detailed problem statement, scope, goals, and acceptance criteria. The skill generates a structured PRD with success criteria, milestones, and risks, saving it as a JSON file in the /plans directory.

What sections are included in a product requirements document for scoping?

A product requirements document for scoping includes Objective, Problem Statement, Scope, Success Criteria, Metrics, Milestones, Risks, and Assumptions. This structure ensures stakeholders share a single vision and reduces ambiguity across the product team.

How do I ensure my PRD captures all necessary requirements and user stories?

To ensure your PRD captures all requirements and user stories, the skill asks guided clarifying questions during generation. It prompts for missing details like constraints and acceptance criteria to validate the complete product scope before outputting the final JSON file.

Can I generate a PRD JSON file without providing acceptance criteria upfront?

You can start generating a PRD without full acceptance criteria upfront. The skill will prompt you with guided clarifying questions to gather missing details, ensuring the final product requirements document contains all necessary validation plans and scope definitions.

Does PRD generation include versioning metadata for change tracking?

PRD generation includes versioning metadata for change tracking within the output JSON file. This ensures that as your product requirements evolve, you can monitor updates to objectives, scope, milestones, and risks throughout the discovery phase.

When should I use automated PRD generation instead of manual documentation?

Use automated PRD generation during product discovery and requirements gathering to turn vague ideas into structured documents quickly. It helps articulate problem statements and define success criteria efficiently, reducing misalignment across stakeholders compared to manual documentation.