question-details

Clarify ambiguous user requirements through restatement, targeted questions, and evidence-based decisions.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/ly0o0o/lyoo-ai-productivity --skill question-details
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: question-details
Source: https://github.com/ly0o0o/lyoo-ai-productivity/tree/main/workflow/question-details
Command: npx skills add https://github.com/ly0o0o/lyoo-ai-productivity --skill question-details

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When user requests are unclear or underspecified, this skill enforces a formal clarification workflow to prevent misalignment and scope creep.

Core Features & Use Cases

  • Restate and confirm understanding before acting.
  • Ask targeted clarifying questions when information is missing.
  • Review relevant context (code, configs, docs) and document decisions with evidence.
  • Execute in small, verifiable steps with acceptance criteria.

Use Case: A product manager provides a vague feature request; the skill guides the team through restatement, questions, and a bounded plan before implementation.

Quick Start

State the goal, scope, and acceptance criteria for your request so I can begin the clarification workflow.

Frequently Asked Questions about question-details

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

FAQPage Schema
How do I clarify vague product requirements before starting development?

To clarify vague product requirements, use a structured workflow that restates the request, asks targeted questions, and defines explicit acceptance criteria before coding begins. This prevents scope creep and ensures alignment.

What is the best way to turn ambiguous feature requests into actionable plans?

Turning ambiguous feature requests into actionable plans requires restating the goal, asking clarifying questions, and reviewing relevant context. This structured clarification process forces evidence-based decision-making to bound scope before implementation.

How do I prevent scope creep when dealing with underspecified user requests?

To prevent scope creep from underspecified user requests, enforce a step-by-step protocol that validates each phase through restatement and targeted questioning. Require explicit acceptance criteria and scope boundaries before executing any implementation.

How does evidence-based decision-making work during requirements clarification?

Evidence-based decision-making during requirements clarification involves reviewing relevant context like code, configs, and docs, then documenting decisions based on that evidence. This validates goals, scope, and external dependencies before execution.

When do I need to enforce a formal clarification workflow for my project?

You need a formal clarification workflow when goals, scope, acceptance criteria, constraints, or external dependencies are ambiguous. It is required prior to implementation to ensure small, verifiable steps and explicit boundary setting.

How to define acceptance criteria for unclear feature requests?

To define acceptance criteria for unclear feature requests, force restate the user's goal, ask targeted clarifying questions to fill information gaps, and review relevant context. This process bounds the scope before coding begins.