ask-questions-if-underspecified

Ask targeted questions about objectives, scope, constraints, and acceptance criteria for underspecified requests.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/graysurf/agent-kit --skill ask-questions-if-underspecified-graysurf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-questions-if-underspecified
Source: https://github.com/graysurf/agent-kit/tree/main/skills/workflows/conversation/ask-questions-if-underspecified
Command: npx skills add https://github.com/graysurf/agent-kit --skill ask-questions-if-underspecified-graysurf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents wasted effort and incorrect implementations by ensuring all necessary details are clarified before starting work on a request.

Core Features & Use Cases

  • Requirement Clarification: Identifies and asks critical questions about objectives, scope, constraints, and acceptance criteria.
  • Assumption Management: Generates a list of assumptions to confirm if the user wishes to proceed without providing answers.
  • Use Case: When asked to "refactor the user authentication module," this skill will ask clarifying questions about the desired scope, security requirements, and compatibility targets before any code is written.

Quick Start

Use the ask questions if underspecified skill to clarify the requirements for the user profile update feature.

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 software requirements before starting implementation?

To clarify underspecified software requirements, this Skill identifies missing details and asks targeted questions about project objectives, scope, constraints, and acceptance criteria before any code is written.

What is the best way to scope ambiguous project management requests?

The best way to scope ambiguous project management requests is to extract missing parameters interactively, generating a list of assumptions to confirm if the user wishes to proceed without providing direct answers.

How does assumption management work for incomplete feature requests?

Assumption management works by identifying gaps in incomplete feature requests and generating a list of assumptions, allowing users to confirm or correct these assumptions to prevent incorrect implementations and wasted effort.

When do I need to ask clarifying questions for a refactoring task?

You need to ask clarifying questions for a refactoring task when the request is underspecified, ensuring critical details like desired scope, security requirements, and compatibility targets are gathered before proceeding with implementation.

Can I use requirement clarification for software development and project management scenarios?

Yes, you can use requirement clarification for software development and project management scenarios where ambiguity can lead to rework, ensuring all necessary details are clarified before starting work on a request.