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.