prd-writer — Claude Code skill: structured PRDs on demand
Turns a feature brief into a structured PRD: problem, solution, requirements, success metrics, timeline and risks. Useful at the start of a new initiative.
npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a claude-codeWhat prd-writer does
prd-writer is a skill that walks the agent through a fixed PRD outline. Five sections come out of it: the problem with user pain points and business impact, the proposed solution with user stories and success metrics, requirements split into functional, technical and design, implementation with dependencies and a timeline estimate, then risks and mitigations. The skill also asks you to state what is in scope and what is not.
It behaves as instructions for the agent rather than a generator with a button. You supply product context, data and constraints; the agent fills the sections in order. The skill takes one argument, the feature name, hinted by argument-hint. Research and data are marked recommended but optional, so a PRD still comes out without them — you will just have to invent the metrics yourself.
The skill advises quantitative success metrics and acceptance criteria for the key flows. If you have no baseline number to measure against, the document turns into a restatement of the idea. Worth settling the metric first, then running the skill.
What it helps with
- document a new feature so engineers know what to build
- lock the scope before design work starts
- write success metrics you can actually measure
- collect user stories and acceptance criteria for key flows
- list dependencies and risks before estimating the timeline
Example prompts for the agent
- write a PRD for a notification center in our SaaS app
- draft a PRD for the report export feature, context below
- PRD for new-user onboarding, metric is share of users reaching the first action
How to install prd-writer
1Skills CLI (Vercel)
npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a claude-code2Manually: put the files in place
~/.claude/skills/prd-writer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/prd-writer/
1Skills CLI (Vercel)
npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a codex2Manually: put the files in place
.agents/skills/prd-writer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a cursor2Manually: put the files in place
.cursor/skills/prd-writer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pmprompt/claude-plugin-product-management prd-writer2Manually: put the files in place
.github/skills/prd-writer/SKILL.md1Skills CLI (Vercel)
npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a gemini-cli2Platform CLI
gemini skills install https://github.com/pmprompt/claude-plugin-product-management --path skills/prd-writerManually: put the files in place
.devin/skills/prd-writer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about prd-writer
How do I install prd-writer in Claude?
Run npx skills add pmprompt/claude-plugin-product-management --skill prd-writer -a claude-code. The skill file then sits at ~/.claude/skills/prd-writer/SKILL.md.
What does prd-writer do?
It produces a structured PRD covering the problem statement, solution with user stories, requirements, implementation and risks. The skill guides the agent through each section.
What input does it need?
Context about your product, feature or problem, plus a clear statement of what you are trying to achieve. Data, research and constraints are recommended but optional.
Source text
SKILL.md · MIT
--- name: prd-writer description: "Generate comprehensive product requirements documents. Use when starting a new feature or product initiative and need structured documentation." argument-hint: "[feature name]" --- ## Domain Context This skill implements a proven product management framework. The approach combines best practices from industry leaders and is designed for practical application in day-to-day PM work. ## Input Requirements - Context about your product, feature, or problem - Relevant data, research, or constraints (recommended but optional) - Clear articulation of what you're trying to achieve # PRD Writer ## When to Use - Starting a new feature or product initiative - Need to document requirements for the engineering team - Stakeholders need a detailed project overview - Before beginning design or development work - To align cross-functional teams on scope and goals ## What This Skill Does Creates structured, comprehensive PRDs covering problem statement, proposed solution, requirements, success metrics, and implementation details. ## Instructions Help me write a comprehensive PRD for [feature name]. Include: 1. Problem Statement - Current situation - User pain points - Business impact 2. Proposed Solution - Overview of the approach - User stories - Success metrics 3. Requirements - Functional requirements - Technical requirements - Design requirements 4. Implementation - Dependencies - Timeline estimate - Resources needed 5. Risks and Mitigations Your context: [Add product context, feature details, and constraints here] ## Best Practices - Be specific about the problem and user pain points - Include quantitative success metrics - Define scope clearly (what's in scope and out of scope) - Consider technical constraints upfront - Add detailed user stories for key flows - Include acceptance criteria ## Example **Input:** Building a notification center for SaaS app, target users are power users who miss important updates **Output:** Full PRD with problem statement, user stories, functional/technical requirements, success metrics (reduce missed notifications by 40%), timeline, and risk assessment ## Further Reading - [Prd Templates](https://pmprompt.com/blog/prd-templates) - [How To Write Prd Using Ai](https://pmprompt.com/blog/how-to-write-prd-using-ai) - [Prd Examples](https://pmprompt.com/blog/prd-examples)
© pmprompt · MIT · pmprompt/claude-plugin-product-management
