ask-questions-if-underspecified

Identify underspecified requests and ask 1-5 clarifying questions before proceeding.

Updated May 4, 2026
One-click install
npx skills add https://github.com/511avolo-dot/MR --skill ask-questions-if-underspecified-511avolo-dot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-questions-if-underspecified
Source: https://github.com/511avolo-dot/MR/tree/main/.agents/skills/ask-questions-if-underspecified
Command: npx skills add https://github.com/511avolo-dot/MR --skill ask-questions-if-underspecified-511avolo-dot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a disciplined approach to requests that lack enough detail by guiding the user to supply essential information through focused clarifying questions, reducing risk of misinterpretation and rework.

Core Features & Use Cases

  • Identify when a request is underspecified and pinpoint missing objective, scope, constraints, environment, and safety details.
  • Generate a concise set of 1-5 must-have clarifying questions, offering clear options and sensible defaults to accelerate alignment.
  • Pause execution to confirm interpretation with the user, continuing only after essential questions are answered or user approves assumptions.

Quick Start

Begin by evaluating the request for underspecification and then ask the minimum must-have questions needed to proceed.

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 vague requirements without overwhelming the user with questions?

To clarify vague requirements, this skill identifies missing scope, constraints, and objectives, then generates a concise set of 1-5 must-have questions with sensible defaults to accelerate alignment.

When do I need to pause task execution for requirements gathering?

You need to pause task execution for requirements gathering when a request is underspecified and multiple interpretations exist, continuing only after essential questions are answered or assumptions are approved.

What is the best way to disambiguate user prompts during task scoping?

The best way to disambiguate user prompts during task scoping is to pinpoint missing environment and safety details, then prompt the user with a minimal set of must-have questions to resolve the ambiguity.

How do I identify if a request lacks enough detail to proceed safely?

You identify if a request lacks enough detail by evaluating it for missing objectives, scope, constraints, and environment details, which reduces the risk of misinterpretation and rework.

Can I use this approach to reduce rework caused by misinterpreted instructions?

Yes, you can use this approach to reduce rework caused by misinterpreted instructions by enforcing a disciplined method that guides users to supply essential information through focused clarifying questions.

What happens if a user approves assumptions instead of answering clarifying questions?

If a user approves assumptions instead of answering clarifying questions, the skill stops pausing execution and proceeds with the confirmed interpretation to complete the underspecified task.