Ask Questions If Underspecified

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

1,160 stars 137 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add MoizIbnYousaf/ai-agent-skills --skill ask-questions-if-underspecified
Manual install
git clone --depth 1 https://github.com/MoizIbnYousaf/ai-agent-skills.git /tmp/ai-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ai-agent-skills/skills/ask-questions-if-underspecified ~/.claude/skills/ask-questions-if-underspecified

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Ask Questions If Underspecified

## Goal

Ask the minimum set of clarifying questions needed to avoid wrong work; do not start implementing until the must-have questions are answered (or the user explicitly approves proceeding with stated assumptions).

## Workflow

### 1) Decide whether the request is underspecified

Treat a request as underspecified if after exploring how to perform the work, some or all of the following are not clear:
- Define the objective (what should change vs stay the same)
- Define "done" (acceptance criteria, examples, edge cases)
- Define scope (which files/components/users are in/out)
- Define constraints (compatibility, performance, style, deps, time)
- Identify environment (language/runtime versions, OS, build/test runner)
- Clarify safety/reversibility (data migration, rollout/rollback, risk)

If multiple plausible interpretations exist, assume it is underspecified.

### 2) Ask must-have questions first (keep it small)

Ask 1-5 questions in the first pass. Prefer questions that eliminate whole branches of work.

Make questions easy to answer:
- Optimize for scannability (short, numbered questions; avoid paragraphs)
- Offer multiple-choice options when possible
- Suggest reasonable defaults when appropriate (mark them clearly as the default/recommended choice; bold the recommended choice in the list, or if you present options in a code block, put a bold "Recommended" line immediately above the block and also tag defaults inside the block)
Read the full skill on GitHub

Details

Skill name
ask-questions-if-underspecified
Path
skills/ask-questions-if-underspecified/SKILL.md
License
MIT
Repo updated
21 September 2026

FAQ

What does the Ask Questions If Underspecified skill do?

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

How do I install the Ask Questions If Underspecified skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add MoizIbnYousaf/ai-agent-skills --skill ask-questions-if-underspecified. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Ask Questions If Underspecified popular?

It lives in MoizIbnYousaf/ai-agent-skills, which has 1,160 GitHub stars and 137 forks, and is included in 1 curated skill list.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.