prd-writer
Scannednpx machina-cli add skill aroyburman-codes/pm-skills/prd-writer --openclawPRD Writer Skill
Generate a complete, structured PRD from a feature idea, problem statement, or brief description.
When to Use
- User needs to write a PRD for a new feature
- User has an idea and wants it turned into a structured spec
- User says
/prd-writerfollowed by a feature description - Any time a product requirement needs to be documented
Framework: PRD Structure
1. Overview
- Feature name: Clear, descriptive name
- Author: [to be filled]
- Date: Current date
- Status: Draft / In Review / Approved
- One-liner: What this feature does in one sentence
2. Problem Statement
- What problem are we solving? Describe the user pain point or business need
- Who has this problem? Primary user segment
- How big is this problem? Estimated impact (users affected, frequency, severity)
- Why solve it now? Urgency, strategic alignment, competitive pressure
3. Goals & Non-Goals
Goals:
- 3-5 specific, measurable goals this feature should achieve
- Each goal maps to a user need or business objective
Non-Goals:
- Explicitly list what this feature will NOT do
- Prevents scope creep and sets expectations
4. User Stories
Write 3-5 user stories in the format:
As a [user type], I want to [action] so that [benefit].
Include acceptance criteria for each:
- Given [context], when [action], then [expected result]
5. Detailed Requirements
Functional Requirements:
| ID | Requirement | Priority (P0/P1/P2) | Notes |
|---|---|---|---|
| FR-1 | |||
| FR-2 |
Non-Functional Requirements:
- Performance: Latency, throughput, scalability targets
- Security: Auth, data handling, compliance
- Accessibility: WCAG level, screen reader support
- Reliability: Uptime, error handling, graceful degradation
For AI/ML features, also include:
- Model requirements: Accuracy, latency, cost per inference
- Data requirements: Training data, eval data, data pipeline
- Safety requirements: Content policy, guardrails, fallback behavior
- Eval criteria: How model quality will be measured
6. UX & Design
- User flow: Step-by-step walkthrough of the primary flow
- Key screens/states: Describe the main UI states (loading, empty, error, success)
- Edge cases: What happens when things go wrong?
- Design references: Links to mockups/wireframes (placeholder)
7. Technical Approach
- Architecture: High-level system design
- Dependencies: APIs, services, teams needed
- Data model: Key entities and relationships
- Migration: Any data migration or backward compatibility concerns
8. Success Metrics
- Primary metric: The one number that tells us this feature worked
- Secondary metrics (3-4): Supporting indicators
- Guardrail metrics (2-3): What must NOT regress
- Measurement plan: How and when to measure
9. Launch Plan
- Rollout strategy: Feature flag → internal → beta → GA
- Launch criteria: What must be true before each stage
- Rollback plan: How to revert if something goes wrong
- Communication: Who needs to know and when
10. Open Questions
- List unresolved questions that need stakeholder input
- Include who should answer each question
Output Format
Generate as clean markdown, ready to paste into Notion, Confluence, Google Docs, or any doc tool. Use tables for requirements. Be specific and actionable — avoid vague language.
Research-First Workflow
- Research — Search for comparable features from competitors, best practices, and relevant technical approaches.
- Generate the complete PRD following the structure above.
- Flag open questions and assumptions that need validation.
Source
git clone https://github.com/aroyburman-codes/pm-skills/blob/main/skills/prd-writer/SKILL.mdView on GitHub Overview
PRD Writer turns a feature idea or problem statement into a complete, structured Product Requirements Document. It creates a formal spec that captures problem definition, goals, user stories, and detailed requirements. The output is adaptable to AI/ML product contexts, ensuring model considerations, data needs, and safety guardrails are included.
How This Skill Works
Input a feature idea or problem statement, and PRD Writer analyzes user needs and business goals. It then outputs a full PRD following the standard structure: Overview, Problem, Goals & Non-Goals, User Stories with acceptance criteria, Detailed Requirements (functional, non-functional, AI/ML specifics), UX & Design, Technical Approach, Success Metrics, and Launch Plan.
When to Use It
- You need a PRD for a new feature.
- You have an idea and want it turned into a structured spec.
- You want to convert a feature description into a complete PRD using /prd-writer.
- Any time product requirements must be formally documented.
- You’re working on an AI/ML product and need model/data/safety considerations included.
Quick Start
- Step 1: Provide a feature idea or problem statement.
- Step 2: Run /prd-writer with the brief and review the generated PRD.
- Step 3: Iterate on sections and finalize the launch plan.
Best Practices
- Start with a clear problem statement and target user.
- Define 3-5 measurable goals mapped to user needs.
- Include 3-5 user stories with acceptance criteria.
- Specify both functional and non-functional requirements, plus AI/ML specifics when applicable.
- Close with a launch plan, success metrics, and guardrails to prevent scope creep.
Example Use Cases
- PRD for an AI-powered chat assistant feature.
- PRD for mobile onboarding flow optimization.
- PRD for AI-driven fraud detection in payments.
- PRD for a product recommender system in an e-commerce app.
- PRD for a data labeling workflow integration.