mcpField
W
writing-prds

writing-prds

github.com/dralgorhythmDevelopment13070 installsUpdated 15w ago
Repository

About writing-prds

A skill for drafting product requirements documents (PRDs), from goals and user stories to requirements and review. It provides a structure and workflow for teams preparing feature specifications.

Key features

  1. 01Goal and success-metric definition
  2. 02Stakeholder and user-story capture
  3. 03Functional and non-functional requirements
  4. 04PRD outline and save location
  5. 05Given/When/Then acceptance criteria

Use cases

  1. 01Drafting a feature PRD
  2. 02Turning user needs into user stories
  3. 03Defining testable acceptance criteria
  4. 04Preparing a requirements document for review

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill writing-prds

After installing, type/writing-prdsin Claude Code to confirm it loaded.

Bundled filesresources/prd.template.md

Details

From the project README

Writing PRDs

Workflows

  • Define Goals: Articulate business goals and success metrics
  • Identify Stakeholders: List all relevant stakeholders
  • Draft User Stories: Capture user needs
  • Detail Requirements: List functional and non-functional requirements
  • Save Artifact: Save to ./artifacts/prd_[feature].md
  • Review: Conduct stakeholder review

PRD Structure

  1. Overview: What and why
  2. Goals & Success Metrics: How we measure success
  3. User Stories: Who benefits and how
  4. Requirements: What must be built
  5. Out of Scope: What we're NOT building
  6. Timeline: Key milestones

User Story Format

As a [role],
I want [feature],
So that [benefit].
Example
As a registered user,
I want to reset my password via email,
So that I can regain access to my account if I forget it.

Acceptance Criteria

Use Given/When/Then format:

Given I am on the login page
When I click "Forgot Password"
Then I see a form to enter my email

Given I enter a valid registered email
When I submit the form
Then I receive a password reset email within 5 minutes

INVEST Criteria

Good user stories are:

  • Independent: Can be developed separately
  • Negotiable: Details can be discussed
  • Valuable: Delivers user value
  • Estimable: Can be sized
  • Small: Fits in a sprint
  • Testable: Has clear acceptance criteria

Resources

Comments

Markdown supported