aidd-requirements

Generate functional requirements in "Given X, should Y" format for user stories.

377|33|Updated Jul 3, 2025
One-click install
npx skills add https://github.com/paralleldrive/aidd --skill aidd-requirements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aidd-requirements
Source: https://github.com/paralleldrive/aidd/tree/main/ai/skills/aidd-requirements
Command: npx skills add https://github.com/paralleldrive/aidd --skill aidd-requirements

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps in creating clear, standardized functional requirements for user stories, reducing ambiguity and improving collaboration.

Core Features & Use Cases

  • Standardized Format: Utilizes a "Given X, should Y" format to ensure consistency and clarity.
  • Focus on User Outcomes: Encourages a focus on user needs and benefits rather than UI elements.
  • Use Case: When drafting new user stories or reviewing existing ones to ensure they are complete and testable.

Quick Start

Use the aidd-requirements skill to generate requirements for a user story: /aidd-requirements "As a user, I want to be able to save my documents so that I can access them later."

Frequently Asked Questions about aidd-requirements

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

FAQPage Schema
How do I write standardized functional requirements for user stories?

To write standardized functional requirements for user stories, use a consistent format like "Given X, should Y" to focus on user outcomes and reduce ambiguity. This approach ensures clarity and improves collaboration between product management and software development teams.

What is the Given X should Y format for product management requirements?

The "Given X, should Y" format for product management requirements is a standardized structure that defines user story outcomes by specifying a condition and an expected result. It encourages focusing on user needs rather than UI specifics to ensure requirements are complete and testable.

How do I generate functional requirements from a user story?

You can generate functional requirements from a user story by processing the story through a standardization tool that outputs a "Given X, should Y" structure. This translates the initial user narrative into clear, testable functional requirements focused on user outcomes.

Why do user story requirements become ambiguous and how to standardize them?

User story requirements become ambiguous when they lack a consistent structure or focus on UI specifics instead of user outcomes. You can standardize them by applying a "Given X, should Y" format, which ensures all requirements are written uniformly and remain testable.

Can I use this approach to review existing user stories for completeness?

Yes, you can use this standardization approach to review existing user stories for completeness and testability. By reformatting them into the "Given X, should Y" structure, you can identify missing outcomes and clarify ambiguous product management requirements.

Does this functional requirement format work for software engineering workflows?

Yes, this functional requirement format works for software engineering workflows by providing clear, standardized user outcomes. It bridges product management and software engineering by ensuring requirements are testable and free of distracting UI specifics.