requirements-clarity

Transform vague requirements into actionable PRDs with acceptance criteria and execution phases.

567|82|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/pedronauck/skills --skill requirements-clarity-pedronauck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements-clarity
Source: https://github.com/pedronauck/skills/tree/main/skills/requirements-clarity
Command: npx skills add https://github.com/pedronauck/skills --skill requirements-clarity-pedronauck

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the common issue of unclear or ambiguous requirements that lead to costly misunderstandings and rework by systematically clarifying them before development begins.

Core Features & Use Cases

  • Systematic Clarification: Guides users through focused questions to identify gaps in functional scope, user interaction, technical constraints, and business value.
  • Iterative Improvement: Continuously assesses requirement clarity using a 100-point scoring system, iterating until a high level of detail is achieved.
  • Actionable Output: Generates a comprehensive Product Requirements Document (PRD) with detailed specifications, acceptance criteria, and execution phases.
  • Use Case: A product manager needs to define a new "user profile editing" feature. They provide a vague initial request, and this Skill asks targeted questions about data fields, validation rules, security, and user roles to produce a development-ready PRD.

Quick Start

Use the requirements-clarity skill to clarify the requirement "implement a new notification system".

Frequently Asked Questions about requirements-clarity

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

FAQPage Schema
How do I transform vague product requirements into an actionable PRD?

To transform vague product requirements into an actionable PRD, use a systematic clarification process that identifies gaps in functional scope, user interaction, technical constraints, and business value to ensure development readiness.

What is the best way to clarify ambiguous specifications before development begins?

The best way to clarify ambiguous specifications is through an iterative improvement process that continuously assesses requirement clarity using a 100-point scoring system, asking targeted questions until a high level of detail is achieved.

How does a systematic clarification process handle gaps in technical constraints and business value?

A systematic clarification process handles gaps in technical constraints and business value by guiding users through focused questions, assigning a clarity score to guide the dialogue, and iterating until the requirements are fully detailed.

Can I generate acceptance criteria and execution phases from a brief feature description?

Yes, you can generate acceptance criteria and execution phases from a brief feature description by inputting the vague request into an iterative clarification workflow that outputs a comprehensive Product Requirements Document with detailed specifications.

What should a product manager do to define functional scope for a new user interaction feature?

A product manager should define functional scope for a new user interaction feature by providing an initial vague request and answering targeted questions about data fields, validation rules, security, and user roles to produce a development-ready PRD.

Are there limitations to using a 100-point scoring system for requirement clarification?

A limitation of using a 100-point scoring system for requirement clarification is that it requires continuous iterative dialogue to achieve a high score, meaning the process cannot generate a detailed PRD from a single vague input without multiple refinement cycles.