ask-questions-if-underspecified

Detect underspecified user requests and prompt must-have clarifying questions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/quantfiction/dotfiles --skill ask-questions-if-underspecified-quantfiction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-questions-if-underspecified
Source: https://github.com/quantfiction/dotfiles/tree/main/claude/plugins/global-skills/skills/ask-questions-if-underspecified
Command: npx skills add https://github.com/quantfiction/dotfiles --skill ask-questions-if-underspecified-quantfiction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarify requirements and identify ambiguity before starting work to prevent misinterpretation and wrong implementations.

Core Features & Use Cases

  • Explicitly detects underspecified requests and guides the user to provide just-in-time, must-have questions.
  • Proactively avoids automatic execution by requiring explicit invocation when underspecification is detected.
  • Provides structured question templates to quickly resolve scope, acceptance criteria, constraints, and environment details.

Quick Start

Provide 1–5 must-have questions to elicit missing details and confirm assumptions before proceeding.

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 underspecified requirements before starting project work?

To clarify underspecified requirements, prompt the user with 1–5 must-have questions to elicit missing details and confirm assumptions before proceeding. This prevents misinterpretation by resolving ambiguity in scope, acceptance criteria, and constraints just in time.

What is the best way to prevent AI workflows from executing with ambiguous scope?

Prevent AI workflows from executing with ambiguous scope by requiring explicit invocation when underspecification is detected. This approach avoids automatic execution and ensures safe, auditable interaction by structuring questions around missing objectives and environment details.

How do I identify missing acceptance criteria and constraints in a user request?

Identify missing acceptance criteria and constraints by detecting underspecified requests and applying structured question templates. These templates guide users to provide the necessary scope, constraints, and environment details required to proceed safely.

When do I need to ask clarifying questions in AI-assisted workflows?

You need to ask clarifying questions in AI-assisted workflows whenever uncertainty is detected regarding objectives, acceptance criteria, scope, constraints, or environment details. Prompting for these must-have details before acting ensures safe and auditable interaction.

Does this approach work without integrating external dependencies or components?

Yes, this approach works without external dependencies or components. It relies entirely on structured questioning templates and explicit invocation logic to resolve underspecification across projects and AI-assisted workflows natively.

Why does my project fail when I automatically execute tasks with missing environment details?

Project execution fails with missing environment details because automatic action leads to misinterpretation and wrong implementations. Requiring explicit invocation and structured questions resolves underspecification, ensuring objectives and constraints are confirmed beforehand.