write-a-prd

Create a structured PRD through user interviews and codebase exploration, saved as a Markdown artifact.

2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/siarhei-belavus/agent-public --skill write-a-prd-siarhei-belavus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/siarhei-belavus/agent-public/tree/main/skills/planning/write-a-prd
Command: npx skills add https://github.com/siarhei-belavus/agent-public --skill write-a-prd-siarhei-belavus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague feature idea into a concrete, actionable product requirements document is hard—ambiguities get missed, scope creeps, and implementation teams lack clear guidance. This Skill interviews you, explores your codebase, and produces a well-structured PRD saved as a local artifact. ## Core Features & Use Cases - Guided Requirements Interview: Asks focused, high-signal questions about the problem, users, goals, constraints, and out-of-scope items. - Codebase-Aware Scoping: Inspects existing modules, terminology, and integration constraints so the PRD reflects real system boundaries. - Standardized PRD Output: Writes a structured prd.md (Summary, Problem, Goals, Non-Goals, Requirements, User Flows, Success Criteria, Risks, Open Questions) under a dedicated .prd/<slug>/ folder with reserved issues/, plans/, and rfcs/ subfolders. - Use Case: You want to add a notifications feature to your app. The Skill asks targeted questions, reviews relevant code, then produces .prd/notifications/prd.md ready for planning and implementation. ## Quick Start Ask the assistant to write a PRD for your feature idea, for example: "Help me write a PRD for adding team workspaces to our app."

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 for a new feature?▼

Describe your feature idea and answer the Skill's focused questions about the problem, users, goals, and constraints. It then explores your codebase and writes a structured prd.md covering requirements, user flows, success criteria, and risks.

What sections should a product requirements document include?▼

This Skill generates a PRD with Summary, Problem, Goals, Non-Goals, Users/Actors, Functional and Non-Functional Requirements, User Flows, Success Criteria, Risks/Dependencies, and Open Questions.

Where does the write-a-prd skill save the PRD file?▼

The PRD is saved at .prd/<prd-slug>/prd.md, where the slug is a short kebab-case name derived from the feature. Sibling folders for issues, plans, and rfcs are also reserved under the same directory.

Does the PRD process require access to my codebase?▼

Codebase exploration is optional but recommended. The Skill inspects related modules, terminology, and integration constraints to ground the PRD in real system boundaries, but it can proceed from the interview alone.

What happens if requirements are still ambiguous after the interview?▼

Unresolved ambiguities are explicitly listed in the PRD's Open Questions section rather than being silently assumed. The final response also summarizes any major open questions that remain.