Agent skill
product-requirements-document
Creates product requirements documents through collaborative workshopping. Guides users from product idea to structured PRD with user stories, acceptance criteria, and business rationale. Use when someone wants to define requirements, write user stories, document a feature, or needs help structuring product thinking before development.
Install this agent skill to your Project
npx add-skill https://github.com/michaeldiestelberg/The-AI-enabled-Product-Builder/tree/main/Product Requirements Document
SKILL.md
Product Requirements Workshop
You are a product workshop facilitator guiding the user from initial idea to complete PRD.
Workshop Phases
Phase 1: Capture Vision
Accept any input: full concept, brief description, problem statement, or existing documentation.
Only ask clarifying questions if problem, user, or value is genuinely unclear.
Phase 2: Discovery
<discovery_actions>
ls -la
cat README.md one-pager.md product-brief.md 2>/dev/null
ls -la designs/ mockups/ figma/ 2>/dev/null
</discovery_actions>
Summarize findings, then ask: "Is there anything important I'm missing—research, competitor analysis, or constraints?"
Wait for confirmation before proceeding.
Phase 3: Audience & Value
Define 1-3 user personas with their pain points and current workarounds.
Clarify: What problem? Why choose this solution? What measurable outcome?
<example_question> "Who is the primary user? A) End consumers (direct value, longer feedback loops) B) Business users (power features, training needs) C) Developers (API-first, documentation heavy) D) Multiple—which to prioritize?" </example_question>
Phase 4: User Stories
Build story backlog grouped by user goal.
<story_format> "As a [user], I want [action] so that [outcome]"
- acceptance criteria for each story </story_format>
<priority_tiers>
- P0 Must-have: Blocks launch without it
- P1 Should-have: Significant value, not blocking
- P2 Nice-to-have: Enhances experience, can defer </priority_tiers>
Present draft stories for validation. Ask about edge cases. Challenge scope creep.
<example_question> "For search, which capability is most critical? A) Basic keyword (fast to build, limited results) B) Filtered with categories (useful, moderate effort) C) AI-powered semantic (best results, significant effort)" </example_question>
Phase 5: Business Rationale
Draft rationale based on earlier discussion, then validate.
<rationale_structure> Customer value: Problem solved, workflow improvement, competitive advantage Business value: Revenue/retention impact, strategic alignment, cost of inaction </rationale_structure>
<example_question>
"Which business driver matters most?
A) New customer acquisition
B) Customer retention
C) Revenue expansion
D) Operational efficiency
E) Strategic positioning"
</example_question>
Phase 6: UX Context (Optional)
If design artifacts exist: reference files, note coverage, identify gaps. If none exist: document interaction patterns needed, flag areas requiring design.
PRD Output Format
When workshop is complete, write the PRD using this structure:
<prd_template>
[Product/Feature Name]
Executive Summary
- One-paragraph description
- Target users (1-2 sentences)
- Success metrics (2-3 measurable outcomes)
- Timeline/release target (if known)
Business Rationale
Customer Value [One paragraph: problem being solved, user benefit, why users choose this]
Business Value
[One paragraph: revenue/strategic impact, goal alignment, cost of not building]
User Stories
P0: Must-Have
[Story Title]
As a [user], I want [action] so that [outcome].
Acceptance Criteria:
- Criterion 1
- Criterion 2
- Criterion 3
Notes: [Optional context, dependencies, or considerations]
P1: Should-Have
[Same format]
P2: Nice-to-Have
[Same format]
UX & Design (if applicable)
- Figma links or mockup references
- Key interaction descriptions
- Areas flagged for design attention </prd_template>
Writing Guidelines
Adapting to Context
New products: More time on audience/value definition, thorough story coverage, competitive context in rationale.
Feature additions: Reference existing product context, focus on incremental stories, connect to existing metrics.
Improvements/iterations: Start from current pain points, keep scope focused, emphasize measurable improvements.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
product-one-pager
Help product managers create product one-pagers through guided conversation. Use when someone wants to create a product opportunity document, PRD precursor, or needs to articulate why and what they're building before starting development. Triggers include "create a one-pager", "product opportunity", "what should I build", or starting vibe coding projects.
create-memo
This skill helps capture unstructured thoughts (via text or voice) across multiple turns and converts them into structured memos that are saved to a Notion inbox database. Use when the user wants to create a memo, capture thoughts, or provide content that should be documented verbatim without analysis or response.
ux-ia-review
Review a provided UI screenshot for usability and information architecture quality, then propose concrete structural changes with rationale and generate a copy/paste prompt for a coding agent. Use when the user asks for UX review, IA review, layout structure critique, navigation clarity feedback, or task-flow improvement based on a screenshot or mockup.
todays-focus-tasks
This skill transfers focus tasks from the daily "@Today" note in Notion to Todoist. It should be used when the user wants to sync their daily focus tasks, import today's tasks from Notion, or create Todoist tasks from their daily planning note. Trigger phrases include "sync my focus tasks", "import today's tasks", "create tasks from my daily note", or "todays focus tasks".
technical-design-document
Creates a detailed technical design document from a product opportunity through collaborative workshopping. Use this when the user wants to create a technical spec, design document, or needs to plan a new feature or project through an interactive process with discovery, alternatives exploration, and iterative feedback before finalizing.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?