writing-prd

Create complete PRDs with user problems, measurable outcomes, and acceptance tests.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/simonheimlicher/spx-claude --skill writing-prd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-prd
Source: https://github.com/simonheimlicher/spx-claude/tree/main/plugins/spx/skills/writing-prd
Command: npx skills add https://github.com/simonheimlicher/spx-claude --skill writing-prd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps product teams create complete, testable Product Requirements Documents (PRDs) that clearly articulate user problems, measurable outcomes, acceptance criteria, scope boundaries, and governance through ADRs and open decisions.

Core Features & Use Cases

  • Guided PRD composition: Provides structured prompts and templates to capture problem statement, outcomes, scope, tests, and product approach.
  • Workflow alignment: Maps PRDs to the repository's phases (understand problem, design outcomes, define scope, write PRD) to ensure consistency and traceability.
  • Evidence-based validation: Enforces measurable outcomes with acceptance tests (Gherkin + E2E code) and documents ADR triggers for key technical decisions.

Quick Start

  1. Review the project workflows to understand the PRD lifecycle and required sections.
  2. Walk through the three phases (problem understanding, outcomes design, scope definition) to establish the measurable goals and boundaries.
  3. Produce the complete PRD file in the correct location with all sections filled and ready for readiness verification.

Frequently Asked Questions about writing-prd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a PRD with measurable user value and acceptance tests?

To draft a PRD with measurable outcomes, you extract user problems, define measurable user value, and document Gherkin acceptance tests. This approach ensures product requirements are testable, scope is verifiable, and features remain tied to user value through E2E validation.

What is the best way to structure acceptance criteria in product requirements using Gherkin?

Structuring acceptance criteria in product requirements using Gherkin involves translating measurable outcomes into Given-When-Then scenarios. This enforces evidence-based validation by linking E2E tests directly to PRD scope boundaries and product approach decisions.

How do I define scope boundaries and ADR triggers when drafting a PRD?

Defining scope boundaries and ADR triggers when drafting a PRD requires documenting the product approach and noting key technical decisions. This governance step ensures open decisions are tracked and ADRs are triggered only when architectural choices impact the measurable outcomes.

Can I use this PRD workflow for both feature-level and project-level requirements?

Yes, you can use this PRD workflow for feature-level, capability, and project-level requirements. It maps phases for understanding problems, designing outcomes, and defining scope to ensure consistency and traceability across any product requirements hierarchy.

Why do my product requirements lack traceability and consistent verification?

Product requirements lack traceability when they skip mapping to repository workflows and measurable outcomes. Aligning PRDs to structured phases for problem understanding, scope definition, and Gherkin acceptance tests ensures verifiable consistency across the lifecycle.