Back to Skills

ask-questions-if-underspecified

Clarify requirements before implementing. Use when serious doubts arise.

5,016stars437forksUpdated 5/6/2026

Security Assessment

Safe(100/100)
Security Score100/100

About ask-questions-if-underspecified

The 'ask-questions-if-underspecified' skill is designed to clarify requirements before implementation begins, addressing situations where requests may have multiple interpretations or lack critical details. This skill helps prevent miscommunication and ensures that the work aligns with the user's expectations by prompting for essential clarifications. By systematically identifying ambiguities, it reduces the risk of proceeding with incorrect assumptions, ultimately leading to more successful outcomes in project execution.

Key features of this skill include a structured workflow that guides users through determining if a request is underspecified, formulating concise clarifying questions, and confirming interpretations before proceeding with implementation. The skill emphasizes the importance of asking a minimal set of targeted questions to eliminate uncertainty, while also providing templates for effective communication. This approach not only streamlines the clarification process but also enhances collaboration between users and implementers, ensuring that all necessary details are addressed before any action is taken.

This skill is particularly useful for project managers, developers, and teams working in environments where requirements may not be fully articulated. It is ideal for scenarios involving software development, product design, and any field where precise specifications are crucial for success. By utilizing this skill, users can foster clearer communication, reduce the likelihood of rework, and ensure that projects meet their intended goals.

FAQ

When should I use this skill?

Use this skill when a request has multiple interpretations or key details are unclear.

What if the request is already clear?

Do not use this skill if the request is clear or if a quick discovery read can answer the missing details.

How many questions should I ask?

Ask 1-5 must-have questions in the first pass to clarify requirements.

What should I do while waiting for answers?

Do not run commands or edit files; perform low-risk discovery steps only.

Can I proceed without answers?

If the user asks to proceed, state your assumptions and confirm them before acting.

Install ask-questions-if-underspecified

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill