Back to Skills

prd-writer

verified

Full 5-stage PRD framework for complex features. Use for deep PRD work via /spec --deep full-prd. For quick feature specs, use /spec --feature instead.

View on GitHub

Marketplace

pm-thought-partner

breethomas/pm-thought-partner

Plugin

pm-thought-partner

Repository

breethomas/pm-thought-partner
10stars

skills/prd-writer/SKILL.md

Last Verified

January 18, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/breethomas/pm-thought-partner/blob/main/skills/prd-writer/SKILL.md -a claude-code --skill prd-writer

Installation paths:

Claude
.claude/skills/prd-writer/
Powered by add-skill CLI

Instructions

# PRD Writer - AI Era Product Specifications

> **DEEP REFERENCE SKILL**
>
> For most PRD work, start with `/spec --feature` (Lite PRD flow).
> Use this skill via `/spec --deep full-prd` when you need:
> - The full 5-stage evolution (Planning → Kickoff → Solution Review → Launch Ready → Impact Review)
> - 15-25 behavior examples for AI features
> - Detailed rollout planning with gates
> - Complete quality checklists

This skill creates modern, decision-focused PRDs that work with AI prototyping tools while maintaining strategic clarity. Based on proven practices from leading tech companies including OpenAI.

## Core Philosophy

**PRDs are about decisions, not documentation.**

A great PRD in 2025:
- Makes explicit decisions at every turn
- Contains concrete examples, not vague descriptions
- Lives and evolves with the product
- Works alongside AI prototyping, not against it
- Is short, sharp, and actionable

**The fatal flaw of bad PRDs**: They say a lot without deciding anything. "Improve engagement" is a hope, not a specification.

## Why PRDs Still Matter

Even with AI prototyping tools (Cursor, Replit, v0), PRDs remain critical because prototypes don't specify:

1. **Strategic context**: How does this fit the overall strategy?
2. **Success criteria**: What metrics define success?
3. **Rollout plan**: Who gets this and when?
4. **Risk management**: What could go wrong and how do we handle it?
5. **Non-goals**: What are we explicitly NOT doing?

**Key insight**: When building fast becomes easy (thanks to AI), knowing what to build becomes even more important.

## The Modern Product Development Flow

**Old flow (linear)**: PRD → Design → Build → Test

**New flow (cyclical)**: Idea → Quick Prototype → PRD → Refined Prototype → Ship

### How PRDs and Prototypes Work Together

**Prototypes as discovery tools**:
- Use AI tools to mock up 3 different approaches in an afternoon
- Each prototype teaches something about the problem space
- PRD captures learnings and sets d

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
13164 chars