ask-questions-if-underspecified

Ask 1–5 multiple-choice questions to clarify underspecified software feature requests.

Updated May 2, 2026
One-click install
npx skills add https://github.com/ayehiaa/my-travel-assistant --skill ask-questions-if-underspecified-ayehiaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-questions-if-underspecified
Source: https://github.com/ayehiaa/my-travel-assistant/tree/main/.agents/skills/ask-questions-if-underspecified
Command: npx skills add https://github.com/ayehiaa/my-travel-assistant --skill ask-questions-if-underspecified-ayehiaa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted effort and incorrect changes by prompting for missing or ambiguous requirements before any implementation begins.

Core Features & Use Cases

  • Underspecification detection: Identifies when objective, acceptance criteria, scope, constraints, environment, or safety/reversibility are unclear.
  • Minimum clarifying questions: Asks only 1–5 must-have questions to eliminate major interpretation branches.
  • Safe pause before action: Avoids running commands or editing files until the key uncertainties are resolved (or the user explicitly approves assumptions).
  • Use case: You request a feature change like “add trip tracking,” but it’s unclear whether you mean UI updates, backend storage, notifications, or integration targets; this skill forces quick alignment on scope and “done” before work starts.

Quick Start

Ask the AI to use this skill when your request is unclear by replying: "Use ask-questions-if-underspecified and ask the minimum must-have questions before proposing a plan."

Frequently Asked Questions about ask-questions-if-underspecified

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

FAQPage Schema
How do I clarify ambiguous software requirements before starting implementation?

To clarify ambiguous software requirements, you need to identify missing objective, scope, and acceptance criteria, then collect minimum must-have answers to prevent wasted effort. This ensures correct changes are made by prompting for missing details before implementation begins.

What is the best way to define scope for a vague feature request?

Defining scope for a vague feature request involves asking 1-5 scannable multiple-choice questions to eliminate major interpretation branches. This forces quick alignment on what constitutes 'done' before any code changes or refactors are executed.

How do I prevent incorrect changes when integration requirements are unclear?

Preventing incorrect changes when integration requirements are unclear requires a safe pause before action. You avoid running commands or editing files until key uncertainties regarding data or rollout risk are resolved or assumptions are explicitly approved.

When do I need to ask clarifying questions for a software refactor?

You need to ask clarifying questions for a software refactor when underspecification is detected. If objective, constraints, environment, or safety and reversibility are unclear, asking must-have questions aligns expectations and prevents incorrect changes.

How does requirement underspecification detection work for feature changes?

Requirement underspecification detection works by identifying when objective, acceptance criteria, scope, constraints, environment, or safety are unclear. It forces quick alignment on scope before work starts, ensuring missing details are prompted before implementation begins.