writing-prds

Write phased PRDs with falsifiable acceptance criteria and decompose them into backlog-ready tasks.

9|1|Updated Aug 28, 2026
One-click install
npx skills add https://github.com/RisorseArtificiali/skills --skill writing-prds-risorseartificiali
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-prds
Source: https://github.com/RisorseArtificiali/skills/tree/main/skills/writing-prds
Command: npx skills add https://github.com/RisorseArtificiali/skills --skill writing-prds-risorseartificiali

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an approved design into a structured plan of record is where ambiguity creeps in: requirements get written as vague wishes, phases become filler, and downstream agents or reviewers receive documents they cannot act on. This Skill produces PRDs written as work orders for strangers — every requirement falsifiable, every phase independently shippable, every open question owned. ## Core Features & Use Cases - Phased PRD authoring: Generates a PRD with a fixed structure (problem, goal, non-goals, decisions, phases, open questions) where each phase ships something verifiable on its own and passes a cancellation test. - Falsifiable acceptance criteria: Enforces atomic, testable, implementation-free criteria per phase, including testing and documentation expectations that are never deferred to a later phase. - Task decomposition: After user approval, converts phases into backlog tasks (via a Backlog.md MCP when available, or a markdown task breakdown otherwise) with verbatim criteria and recorded dependencies. - Use Case: After brainstorming and grilling have settled the design for a new feature, invoke this Skill to produce a dated PRD in docs/prd/, get it approved, and create one task per phase ready for implementation planning. ## Quick Start Ask the agent to write the PRD for the approved design from the brainstorming session and break it into tasks.

Frequently Asked Questions about writing-prds

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

FAQPage Schema
How do I write a PRD with testable acceptance criteria?▼

Write each acceptance criterion as an atomic, falsifiable statement describing observable behavior, such as returning a 422 with a field-level message on invalid payloads. Avoid implementation details like file names, and include testing and documentation expectations inside each phase.

How to break a PRD into tasks for a backlog?▼

Create one task per phase by default, copying the phase's acceptance criteria verbatim and restating the problem context so the task stands alone. Record dependencies matching the PRD's Depends on lines, and create all tasks in one session to keep them consistent.

When should I write a PRD versus an implementation plan?▼

Write a PRD after brainstorming and grilling have produced an approved design; it captures what must be true and why, phase by phase. Implementation plans come later, one per task, and describe how file by file.

Can I write a PRD directly from a raw idea or GitHub issue?▼

No, a PRD requires a validated problem understanding and grilling decisions first. For a GitHub issue, read it with gh issue view and treat unresolved discussion threads as open questions before drafting.

What are the limitations of phase-based PRD decomposition?▼

Phases must each ship something verifiable on their own and be sized for one agent session and one review. Setup-only phases are folded into the first phase delivering behavior, and any TBD must live in the Open questions section with an owner.