writing-prds
refoundai/lenny-skills
Write effective PRDs using frameworks from 11 product leaders.
What is writing-prds?
This skill helps you create product requirements documents that drive clarity and action. Use it when documenting product requirements, preparing specs for engineering, writing feature briefs, or defining what to build for your team.
- Start with problem and context before solutions
- Define success metrics upfront to measure feature impact
- Choose the right format: traditional docs, prototypes, or executable evals
- Keep PRDs lightweight and actionable to ensure they're actually used
- Use PR/FAQ format to force clarity on customer, problem, and solution
- Build functional prototypes and prompt sets as core requirements for AI features
How to install writing-prds
npx skills add https://github.com/refoundai/lenny-skills --skill writing-prdsHow to use writing-prds
- 1.Start by identifying the problem being solved and why it matters now
- 2.Define how you'll measure success before writing requirements
- 3.Choose your format: traditional document, prototype, or executable evals
- 4.Write a press release or FAQ to clarify customer, problem, and solution
- 5.For AI features, include functional prototypes and prompt sets as core requirements
- 6.Keep the document lightweight—focus on key outcomes, not exhaustive details
- 7.Explicitly list what's out of scope to prevent scope creep
Use cases
- Writing a feature brief for your engineering team with clear success criteria
- Creating a PR/FAQ to validate a new product idea before full development
- Documenting AI product requirements with functional prototypes and prompt sets instead of static prose
- Defining scope and preventing scope creep by explicitly listing what's out of scope
- Justifying investment timing by articulating why this feature matters now versus later
- Product managers writing specs for engineering teams
- Founders and leaders defining what to build
- Teams building AI products who need executable requirements
- Anyone preparing feature briefs or product documentation
writing-prds FAQ
For AI and UI features, prototypes and live demos communicate more effectively than prose. For complex features, consider a PR/FAQ format. Use traditional docs only when you need to scaffold basics—then focus on high-level strategy and narrative.
The first section: background, context, and the problem. Lead with why this matters and why it matters now, before discussing any solutions.
Keep it lightweight. Include the minimal context needed to ensure everyone's on the same page and key outcomes are clear. Exhaustive detail often gets ignored—focus on what drives action.
A good PRD leads to clear team action and reduces ambiguity. For AI products, translate requirements into executable evaluations that run continuously. If your team keeps asking clarifying questions, the PRD needs more specificity.
Yes. Use AI to scaffold basics like user stories and out-of-scope items. Then focus your effort on high-level strategy, narrative, and the 'why now' justification.
Full instructions (SKILL.md)
Source of truth, from refoundai/lenny-skills.
name: writing-prds description: Help users write effective PRDs. Use when someone is documenting product requirements, preparing specs for engineering, writing feature briefs, or defining what to build for their team.
Writing PRDs
Help the user write effective product requirements documents using frameworks and insights from 11 product leaders.
How to Help
When the user asks for help with PRDs:
- Start with the why - Ask about the problem being solved and why it matters now, before features
- Define success upfront - Help them articulate how they'll know the feature succeeded
- Choose the right format - Discuss whether they need a traditional doc, a prototype, or executable evals
- Keep it actionable - Ensure the document leads to clear team action, not just documentation
Core Principles
Lead with problem and context
Maggie Crowley: "The most important section is the first part - what is the background and context? What is the problem, why does it matter, and why does it matter now?" Center the team on the 'why' and the urgency before discussing solutions.
The PR/FAQ forces clarity
Bill Carr: "Whenever we're devising a new product, we start by writing a press release describing it in a way that speaks to the customer. The idea better jump off the page." Use the PR to describe customer, problem, and solution in factual, data-rich language.
Demos before memos in AI age
Aparna Chennapragada: "If you're not prototyping and building to see what you want to build, you're doing it wrong. Prompt sets are the new PRDs." For AI features, include functional prototypes and prompt sets as core requirements.
Evals as living PRDs
Hamel Husain & Shreya Shankar: "This is the purest sense of what a product requirements document should be - this eval judge that's telling you exactly what it should be, and it's automatic and running constantly." Translate product requirements into executable evaluations for AI products.
Keep it lightweight for action
Eric Simons: "We tend to keep them pretty light. I like to have the minimal amount of context that ensures everyone's on the same page and that key outcomes will be present when we get there." Focus on key outcomes rather than exhaustive details that developers ignore.
PRDs demonstrate craft
Vikrama Dhiman: "Is your PRD quality good enough? Are you writing drafts that go to care teams, marketing teams? You must have impact through the artifacts you work on." High-quality PRDs demonstrate professional craft and create clarity at scale.
AI can scaffold the basics
Claire Vo: "I had used ChatGPT to come up with a very serviceable PRD spec for this very technical product." Use AI to scaffold basics like user stories and out-of-scope items, then focus on high-level strategy and narrative.
Live PRDs reduce ambiguity
Guillermo Rauch: "The product management team is now actually building the product. We've specced out in v0, think of it as a live PRD. The amount of detail - we're all saying 'just ship it.'" Interactive, animated prototypes reduce ambiguity and speed up approval.
Include the 'Why Now'
Justify the timing of this investment against other opportunities. If you can't explain why this matters now versus later, the priority is questionable.
Questions to Help Users
- "What problem is this solving, and why does it matter now?"
- "How will you know if this feature was successful - what metric moves?"
- "Who is the customer, and what does their life look like after this ships?"
- "What is explicitly out of scope to prevent scope creep?"
- "Could you build a quick prototype instead of writing more documentation?"
- "What are the key decisions that still need to be made?"
Common Mistakes to Flag
- Starting with the solution - The document should lead with the problem and context
- No success criteria - Every PRD needs a clear definition of how you'll measure success
- Exhaustive detail - Lightweight PRDs focused on outcomes are more likely to be read and used
- Static when prototypes work better - For AI and UI work, live prototypes communicate more than prose
- Missing the 'Why Now' - Without urgency justification, priorities will be questioned
Deep Dive
For all 14 insights from 11 guests, see references/guest-insights.md
Related Skills
- Writing Specs & Designs
- Working Backwards
- Stakeholder Alignment
- Shipping Products
Related skills
More from refoundai/lenny-skills and the wider catalog.
personal-productivity
Help users manage time and tasks effectively using proven techniques from product leaders.
competitive-analysis
Understand competitive dynamics and position against the status quo, not just direct competitors.
brand-storytelling
Craft compelling brand narratives that make your story memorable and repeatable.
startup-ideation
Generate and evaluate startup ideas using frameworks from product leaders.
content-marketing
Build sustainable content marketing strategies using frameworks from 23 product leaders.
vibe-coding
Build functional software through natural language with AI coding tools—no deep technical skills required.