write-a-prd

Generate a PRD and GitHub issue from problem descriptions and repository exploration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PRD creation is typically manual and iterative, leading to misalignment, duplicated effort, and delayed delivery. This skill guides you from a detailed problem description through repository exploration and stakeholder interviews to a complete, ready-to-submit PRD.

Core Features & Use Cases

  • Interview-driven requirements gathering: collects user needs through structured conversations, ensuring alignment with real problems.
  • Repo-informed validation: cross-checks assumptions against the codebase to reduce scope creep.
  • Templated PRD drafting and GitHub issue submission: outputs a ready-to-issue document using a standardized template.
  • Module design sketching: outlines major components and interfaces to enable early feedback and risk assessment.
  • Use Case: When planning a new feature, you can elicit requirements, verify feasibility in the repo, and produce a PRD and GitHub issue in one flow.

Quick Start

Follow the prompts to gather a long, detailed problem description, explore the repository to validate context, conduct structured interviews, sketch required modules, and produce the PRD using the template as a GitHub issue.

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 from user interviews and codebase analysis?

To write a PRD from interviews and codebase analysis, gather a detailed problem description, validate context via repository exploration, conduct structured stakeholder interviews, and draft the PRD using a standardized template.

What is the best way to create a GitHub issue template for product requirements?

Creating a GitHub issue template for product requirements involves defining explicit acceptance criteria, outlining major modules, and structuring the document so it is ready to submit directly to a repository.

How do I gather product requirements through structured interviews?

Gathering product requirements through structured interviews requires collecting user needs via targeted conversations that elicit a long problem description, ensuring alignment with real problems before drafting documentation.

Can I validate PRD assumptions against an existing codebase?

You can validate PRD assumptions against an existing codebase by performing repository exploration to cross-check proposed features, reduce scope creep, and verify technical feasibility before finalizing requirements.

How to prevent scope creep when drafting product documentation?

Preventing scope creep when drafting product documentation requires repo-informed validation to cross-check assumptions against the codebase and structured interviews to maintain shared understanding of the actual requirements.

Does this PRD workflow work for system redesigns and new features?

This PRD workflow works for system redesigns and new features by applying a standardized process to gather problem descriptions, sketch module designs, and generate a ready-to-submit GitHub issue with acceptance criteria.