ask-questions-if-underspecified

Ask 1–5 structured clarifying questions before implementing underspecified tasks.

1|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/adamatdevops/forge-works --skill ask-questions-if-underspecified-adamatdevops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-questions-if-underspecified
Source: https://github.com/adamatdevops/forge-works/tree/main/.skills/trailofbits/ask-questions-if-underspecified
Command: npx skills add https://github.com/adamatdevops/forge-works --skill ask-questions-if-underspecified-adamatdevops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted effort and wrong outcomes by catching when a request is missing objective, scope, constraints, environment, or safety details.

Core Features & Use Cases

  • Clarifying-question gatekeeping: Identifies underspecification and asks only the minimum must-have questions (typically 1–5) before proceeding.
  • Fast, low-friction discovery: Uses structured, scannable, multiple-choice style questions with defaults and a “reply with defaults” option.
  • Safety-first execution control: Avoids commands, edits, or implementation-dependent planning until the key answers arrive or the user approves stated assumptions.

Quick Start

Use this skill to respond by asking the smallest set of clarifying questions needed to resolve ambiguities in the user’s request.

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 prevent wrong software implementation when project requirements are underspecified?

To prevent wrong implementation, pause execution and ask targeted clarifying questions. Identifying underspecified objectives, scope, and constraints before taking action ensures the final deliverable matches the actual project requirements.

What is the best way to clarify ambiguous acceptance criteria before starting automation work?

The best way to clarify ambiguous acceptance criteria is using a gatekeeping mechanism that asks 1 to 5 must-have multiple-choice questions. This provides structured options with default fast-path acceptance to resolve scope ambiguities efficiently.

How do I enforce a clarification gate for software engineering tasks with unclear scope?

You enforce a clarification gate by pausing implementation commands and edits until the user provides answers or explicitly approves stated assumptions. This safety-first execution control prevents incorrect planning for engineering tasks with unclear scope.

Can I use default assumptions to proceed with development when environment constraints are missing?

Yes, you can proceed with development by relying on default assumptions. When environment constraints are missing, the system offers a reply with defaults option, allowing you to fast-path execution by explicitly approving those default assumptions.

When should I pause implementation to ask for planning guardrails in software projects?

You should pause implementation to ask for planning guardrails whenever a request can be interpreted in multiple ways. If safety details, constraints, or acceptance criteria are unclear, pausing prevents wasted effort and wrong outcomes.