engineering-dev-clarify-requirements

Asks targeted clarifying questions before implementing ambiguous development requests.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/scanady/nexus-skills --skill engineering-dev-clarify-requirements-scanady
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: engineering-dev-clarify-requirements
Source: https://github.com/scanady/nexus-skills/tree/main/skills/engineering-dev-clarify-requirements
Command: npx skills add https://github.com/scanady/nexus-skills --skill engineering-dev-clarify-requirements-scanady

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ambiguous or underspecified requests often lead developers and AI agents to build the wrong thing, wasting effort on work that must be redone. This Skill inserts an intake gate that detects ambiguity and asks the minimum set of sharp questions before any implementation begins. ## Core Features & Use Cases - Ambiguity Detection: Evaluates requests against six dimensions (objective, definition of done, scope, constraints, environment, safety) to decide whether clarification is needed. - Minimal Question Sets: Produces 1-5 short, numbered, multiple-choice questions with recommended defaults and a fast-path defaults reply option. - Implementation Hold: Blocks commands, edits, and dependent plans until must-have answers arrive or the user confirms stated assumptions. - Use Case: A user asks to "add caching to the API." Instead of guessing, the agent asks which endpoints are in scope, what TTL is acceptable, and whether existing infrastructure must be reused, then restates the confirmed interpretation before coding. ## Quick Start Ask the agent to clarify the requirements and scope of this task before writing any code.

Frequently Asked Questions about engineering-dev-clarify-requirements

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

FAQPage Schema
How do I clarify ambiguous requirements before coding?▼

Assess the request against six dimensions: objective, definition of done, scope, constraints, environment, and safety. If any remain unclear, ask 1-5 short multiple-choice questions with recommended defaults, and wait for answers before implementing.

How many clarifying questions should I ask before starting a task?▼

Keep the first pass to 1-5 questions that each eliminate whole branches of wrong work. Make them trivial to answer with numbered multiple-choice options, bolded defaults, and a fast-path reply like 'defaults' to accept all recommendations.

When should I not ask clarifying questions?▼

Skip questions when the request has a single clear interpretation, when a quick low-risk read of configs or existing code answers it faster, or when a wrong guess is cheap and instantly reversible.

What should I do if the user says proceed without answering?▼

State your assumptions as a short numbered list and get explicit confirmation before starting. Do not run commands, edit files, or write detailed dependent plans while must-have questions remain open.

Why does asking too many questions slow down requirement gathering?▼

Long open-ended question lists create friction and delay answers. Tight multiple-choice questions with defaults and a one-line reply format let users respond in seconds while still resolving the critical unknowns.