requirements-clarity

Clarifies vague product requirements into a structured PRD with a 100-point score.

6|1|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/mgajewskik/opencode-config --skill requirements-clarity-mgajewskik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements-clarity
Source: https://github.com/mgajewskik/opencode-config/tree/main/skills/requirements-clarity
Command: npx skills add https://github.com/mgajewskik/opencode-config --skill requirements-clarity-mgajewskik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts vague, ambiguous requirements into actionable product specifications by guiding a structured clarification process and applying a 100-point clarity score to quantify gaps.

Core Features & Use Cases

  • Systematic clarification rounds that identify missing details across functional scope, user interactions, technical constraints, and business value.
  • Interactive gap analysis and targeted questions (2-3 per round) to iteratively raise clarity until PRD readiness.
  • Automated PRD generation with sections for background, requirements, design decisions, acceptance criteria, and execution phases, ready for development handoff.

Quick Start

Provide your initial vague requirement to begin the clarification workflow and generate a development-ready PRD.

Frequently Asked Questions about requirements-clarity

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

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

To turn vague requirements into an actionable PRD, use a structured clarification workflow that applies a 100-point clarity score. It iteratively asks targeted questions to identify missing details until the score reaches 90/100, then generates a development-ready document.

What is a clarity score in product requirement clarification?

A clarity score is a 100-point metric used to quantify gaps in vague product requirements. It measures completeness across functional scope, user interactions, technical constraints, and business value to determine when a PRD is ready for development handoff.

How do I generate a PRD for development handoff from a complex feature request?

You generate a PRD for development handoff by processing complex feature requests through iterative gap analysis. The output is a complete document saved to ./docs/prds/{feature-name}-v{version}-prd.md, containing background, requirements, design decisions, acceptance criteria, and execution phases.

What sections are included in a development-ready PRD?

A development-ready PRD includes sections for background, requirements, design decisions, acceptance criteria, and execution phases. These components are automatically generated once the requirement clarification process reaches a 90/100 clarity score.

How many clarification rounds are needed before a PRD is ready?

The number of clarification rounds needed varies based on the initial vagueness of the requirement. The process iteratively asks 2-3 targeted questions per round until the 100-point clarity score reaches 90/100, ensuring all functional and technical gaps are resolved.

Can I use automated PRD generation for unclear cross-team feature requests?

Yes, automated PRD generation is designed for unclear or complex feature requests across teams. It systematically identifies missing details across functional scope, user interactions, technical constraints, and business value to produce structured specifications for handoff.