ask-questions-if-underspecified

Ask multiple-choice clarifying questions to resolve underspecified task requirements before implementation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents wasted effort and rework by ensuring task requirements are clear and unambiguous before implementation begins.

Core Features & Use Cases

  • Ambiguity Detection: Identifies missing details in objectives, acceptance criteria, scope, and constraints.
  • Concise Questioning: Generates targeted, multiple-choice questions with sensible defaults to quickly resolve unknowns.
  • Workflow Pause: Halts implementation until critical questions are answered or the user approves proceeding with stated assumptions.
  • Use Case: When given a vague ticket like "Improve user onboarding," this Skill will ask clarifying questions about the target user segment, specific metrics for improvement, and any design constraints before any code is written.

Quick Start

Ask clarifying questions about the requirements for the ticket "Implement user profile editing".

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 requirements before coding to avoid rework on vague tickets?

Clarifying requirements before coding involves identifying gaps in objectives, acceptance criteria, scope, and constraints, then pausing implementation until those critical details are resolved. This prevents wasted effort by ensuring task requirements are unambiguous before development begins.

What is the best way to resolve underspecified task requirements in software engineering?

Resolving underspecified task requirements is best achieved by generating targeted, multiple-choice questions with sensible defaults. This approach quickly highlights missing details in scope and constraints, allowing developers to state assumptions or gather necessary answers before proceeding.

How do I ask clarifying questions about ambiguous project scope without slowing down development?

Asking concise, targeted questions with sensible defaults balances ambiguity resolution with development speed. It pauses workflow only for must-have answers, allowing the user to explicitly approve proceeding with stated assumptions if details remain unknown.

Can I proceed with implementation if task constraints are missing but I have sensible defaults?

Proceeding with implementation when constraints are missing is possible if the user explicitly approves proceeding with stated assumptions. The workflow pause lifts once must-have answers are provided or the user accepts the defaults.

When should I not use an automated scoping tool for requirement ambiguity?

Automated scoping tools for requirement ambiguity should not be used when a task is already fully specified with clear acceptance criteria and constraints. They are designed specifically to halt implementation only when gaps in objectives or scope are detected.

Does requirement clarification work for improving vague tickets like user onboarding tasks?

Requirement clarification works effectively for vague tickets by asking specific questions about target user segments, improvement metrics, and design constraints. It detects the missing details in such underspecified tasks and presents concise questions to resolve them.