ask-questions-if-underspecified

Identify underspecified requests and generate targeted clarifying questions before execution.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.

Core Features & Use Cases

  • Asks the minimum must-have questions needed to avoid wrong work
  • Pauses execution until user provides necessary answers
  • Restates assumptions and constraints before proceeding, aligning with repo governance when present

Quick Start

Ask the minimum must-have questions required to clarify an underspecified request and wait for user answers before taking any action

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 automation or coding tasks?

To clarify underspecified requirements, you must identify unclear objectives, scopes, or constraints and generate targeted clarifying questions. This ensures must-have questions are asked first, pausing execution until answers are provided before proceeding.

When should I ask clarifying questions during requirements gathering?

You should ask clarifying questions during requirements gathering whenever the objective, scope, or constraints of an automation or coding task are unclear. This prevents wrong work by ensuring assumptions are restated and aligned with repo governance before execution.

What is the best way to avoid wrong work when given an unclear project scope?

The best way to avoid wrong work when given an unclear project scope is to ask the minimum must-have questions required to clarify the request. Restate assumptions and constraints, pausing execution until the user provides necessary answers.

Does this requirements clarification process automatically trigger for every request?

No, this requirements clarification process does not trigger automatically. It must be invoked explicitly only when needed to identify underspecified requests, generate targeted questions, and pause execution for necessary answers.

How do I align assumptions with repository governance before proceeding with a task?

To align assumptions with repository governance before proceeding, restate your assumptions and constraints after gathering necessary answers. This ensures the clarified requirements match governance rules before taking any further action on the task.