write-a-prd

Convert product ideas into structured PRDs through user interviews and repository exploration.

1|Updated May 11, 2026
One-click install
npx skills add https://github.com/skalanux/puntofiles --skill write-a-prd-skalanux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/skalanux/puntofiles/tree/main/dot_agents/skills/write-a-prd
Command: npx skills add https://github.com/skalanux/puntofiles --skill write-a-prd-skalanux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you convert a vague product or feature idea into a structured PRD that aligns stakeholders by clarifying goals, users, requirements, edge cases, and implementation constraints.

Core Features & Use Cases

  • User interview-driven discovery: turns a free-form problem description into an unambiguous shared understanding through relentless, branch-by-branch questioning.
  • Repo-aware requirement validation: explores the codebase to verify assumptions, surface affected modules, and identify existing patterns and constraints.
  • Module-focused design and PRD authoring: designs major modules as deep, testable building blocks and outputs a complete PRD (problem, solution, user stories, decisions, module design, testing, and open questions).

Quick Start

Tell the AI your detailed feature idea and the file format and location you want for the PRD, and it will explore the repo, interview you to resolve ambiguity, and then write and save the PRD for you.

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 product requirements document from a vague feature idea?

To write a product requirements document from a vague idea, the system conducts user interviews to resolve ambiguity and explores your codebase to validate assumptions. It then outputs a complete PRD with user stories, module design, and testing decisions.

How does codebase exploration improve feature planning and PRD generation?

Codebase exploration improves feature planning by verifying technical assumptions and surfacing affected modules during PRD generation. It identifies existing patterns and constraints to ensure the module design aligns with your current software architecture.

Can I define module-level implementation approaches within a generated PRD?

Yes, you can define module-level implementation approaches within the generated PRD. The system designs major modules as deep, testable building blocks, capturing explicit implementation decisions alongside user stories and out-of-scope boundaries.

What is the best way to align stakeholders on new feature requirements?

The best way to align stakeholders on new feature requirements is through structured user interview-driven discovery. This process turns free-form problem descriptions into an unambiguous shared understanding by asking relentless, branch-by-branch questions.

Does this PRD generation process handle edge cases and out-of-scope boundaries?

Yes, the PRD generation process explicitly handles edge cases and out-of-scope boundaries. The final document includes exhaustive user stories, explicit testing decisions, and a dedicated section for open questions to clarify project limits.

What do I need to start generating a PRD for my software project?

To start generating a PRD for your software project, you need to provide a detailed feature idea and specify your desired file format and location. The system will then explore the repository, interview you, and save the PRD.