requirements

Organize user requirements into a structured requirements.md with personas and success criteria.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/swat9013/dotfiles --skill requirements-swat9013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements
Source: https://github.com/swat9013/dotfiles/tree/main/.claude-global/skills/requirements
Command: npx skills add https://github.com/swat9013/dotfiles --skill requirements-swat9013

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill takes ambiguous or incomplete stakeholder requests and structures them into a clear, actionable requirements.md so teams can align on what to build and how success will be measured.

Core Features & Use Cases

  • 5W1H structuring: Transform raw briefs or discovery notes into organized Who/What/When/Where/Why/How sections.
  • Measurable success criteria & scope: Define concrete KPIs, acceptance criteria, MoSCoW prioritization, and explicit in-scope/out-of-scope boundaries.
  • Templates and validation: Produce Minimal or Full requirements.md using built-in templates and check success criteria with the validation checklist for review-ready deliverables.
  • Use case: A product manager provides a short feature request and discovery artifacts; the Skill produces personas, user stories, success metrics, and up to three clarification questions for stakeholders.

Quick Start

Ask the requirements skill to generate a requirements.md from your project brief and any discovery.md, focusing on 5W1H, personas, measurable success criteria, and up to three NEEDS CLARIFICATION items.

Frequently Asked Questions about requirements

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

FAQPage Schema
How do I turn ambiguous stakeholder briefs into structured user stories and requirements?

To turn ambiguous stakeholder briefs into structured user stories, apply 5W1H structuring to organize raw discovery notes. This process validates user needs and generates personas, explicit scope boundaries, and measurable success criteria.

What is the best way to define measurable success criteria and scope for a new feature?

The best way to define measurable success criteria and scope is by using MoSCoW prioritization alongside concrete KPIs. This method establishes explicit in-scope and out-of-scope boundaries, ensuring alignment on feature success metrics.

Can I generate a requirements.md from raw discovery artifacts and short feature requests?

Yes, you can generate a requirements.md from raw discovery artifacts and short feature requests. The process applies built-in Minimal or Full templates to extract personas, user stories, and up to three clarification questions for stakeholders.

How does MoSCoW prioritization work when structuring product requirements?

MoSCoW prioritization works when structuring product requirements by categorizing features into Must, Should, Could, and Won't tiers. This framework establishes clear scope boundaries and aligns stakeholder expectations on deliverables.

When do I need to use 5W1H structuring for product and feature requests?

You need to use 5W1H structuring for product and feature requests when dealing with ambiguous or incomplete stakeholder briefs. It organizes raw discovery notes into clear Who, What, When, Where, Why, and How sections for actionable alignment.

What should a requirements document include to be review-ready for stakeholders?

A review-ready requirements document should include personas, user stories, MoSCoW prioritization, measurable success criteria, and explicit constraints. It must also list up to three clarification questions to resolve remaining stakeholder ambiguities.