{"id":"f06dbc10-76ec-49b9-a0df-04a50a9f8d46","shortId":"se3Xda","kind":"skill","title":"ask-questions-if-underspecified","tagline":"Clarify requirements before implementing. Use when serious doubts arise.","description":"# Ask Questions If Underspecified\n\n## When to Use\nUse this skill when a request has multiple plausible interpretations or key details (objective, scope, constraints, environment, or safety) are unclear.\n\n## When NOT to Use\n\nDo not use this skill when the request is already clear, or when a quick, low-risk discovery read can answer the missing details.\n\n## Goal\n\nAsk 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).\n\n## Workflow\n\n### 1) Decide whether the request is underspecified\n\nTreat a request as underspecified if after exploring how to perform the work, some or all of the following are not clear:\n- Define the objective (what should change vs stay the same)\n- Define \"done\" (acceptance criteria, examples, edge cases)\n- Define scope (which files/components/users are in/out)\n- Define constraints (compatibility, performance, style, deps, time)\n- Identify environment (language/runtime versions, OS, build/test runner)\n- Clarify safety/reversibility (data migration, rollout/rollback, risk)\n\nIf multiple plausible interpretations exist, assume it is underspecified.\n\n### 2) Ask must-have questions first (keep it small)\n\nAsk 1-5 questions in the first pass. Prefer questions that eliminate whole branches of work.\n\nMake questions easy to answer:\n- Optimize for scannability (short, numbered questions; avoid paragraphs)\n- Offer multiple-choice options when possible\n- 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)\n- Include a fast-path response (e.g., reply `defaults` to accept all recommended/default choices)\n- Include a low-friction \"not sure\" option when helpful (e.g., \"Not sure - use default\")\n- Separate \"Need to know\" from \"Nice to know\" if that reduces friction\n- Structure options so the user can respond with compact decisions (e.g., `1b 2a 3c`); restate the chosen options in plain language to confirm\n\n### 3) Pause before acting\n\nUntil must-have answers arrive:\n- Do not run commands, edit files, or produce a detailed plan that depends on unknowns\n- Do perform a clearly labeled, low-risk discovery step only if it does not commit you to a direction (e.g., inspect repo structure, read relevant config files)\n\nIf the user explicitly asks you to proceed without answers:\n- State your assumptions as a short numbered list\n- Ask for confirmation; proceed only after they confirm or correct them\n\n### 4) Confirm interpretation, then proceed\n\nOnce you have answers, restate the requirements in 1-3 sentences (including key constraints and what success looks like), then start work.\n\n## Question templates\n\n- \"Before I start, I need: (1) ..., (2) ..., (3) .... If you don't care about (2), I will assume ....\"\n- \"Which of these should it be? A) ... B) ... C) ... (pick one)\"\n- \"What would you consider 'done'? For example: ...\"\n- \"Any constraints I must follow (versions, performance, style, deps)? If none, I will target the existing project defaults.\"\n- Use numbered questions with lettered options and a clear reply format\n\n```text\n1) Scope?\na) Minimal change (default)\nb) Refactor while touching the area\nc) Not sure - use default\n2) Compatibility target?\na) Current project defaults (default)\nb) Also support older versions: <specify>\nc) Not sure - use default\n\nReply with: defaults (or 1a 2a)\n```\n\n## Anti-patterns\n\n- Don't ask questions you can answer with a quick, low-risk discovery read (e.g., configs, existing patterns, docs).\n- Don't ask open-ended questions if a tight multiple-choice or yes/no would eliminate ambiguity faster.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["ask","questions","underspecified","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-ask-questions-if-underspecified","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/ask-questions-if-underspecified","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34964 github stars · SKILL.md body (4,171 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-25T00:50:28.577Z","embedding":null,"createdAt":"2026-04-18T21:31:29.561Z","updatedAt":"2026-04-25T00:50:28.577Z","lastSeenAt":"2026-04-25T00:50:28.577Z","tsv":"'-3':438 '-5':200 '1':107,199,437,458,519 '1a':558 '1b':330 '2':188,459,467,536 '2a':331,559 '3':342,460 '3c':332 '4':424 'accept':148,288 'act':345 'alreadi':56 'also':272,545 'ambigu':600 'answer':68,96,218,350,404,432,569 'anti':561 'anti-pattern':560 'appropri':238 'approv':101 'area':530 'aris':14 'arriv':351 'ask':2,15,73,189,198,399,413,565,585,635 'ask-questions-if-underspecifi':1 'assum':184,470 'assumpt':105,407 'avoid':82,225 'b':478,525,544 'block':261,270,277 'bold':246,264 'boundari':643 'branch':211 'build/test':171 'c':479,531,549 'care':465 'case':152 'chang':141,523 'choic':230,245,249,291,595 'chosen':335 'clarif':637 'clarifi':6,78,173 'clear':57,135,241,370,515,610 'code':260 'command':355 'commit':382 'compact':327 'compat':161,537 'config':393,579 'confirm':341,415,420,425 'consid':485 'constraint':37,160,442,490 'correct':422 'criteria':149,646 'current':540 'data':175 'decid':108 'decis':328 'default':236,274,286,306,506,524,535,542,543,553,556 'default/recommended':244 'defin':136,146,153,159 'dep':164,497 'depend':364 'describ':614 'detail':34,71,361 'direct':386 'discoveri':65,375,576 'doc':582 'done':147,486 'doubt':13 'e.g':284,302,329,387,578 'easi':216 'edg':151 'edit':356 'elimin':209,599 'end':588 'environ':38,167,626 'environment-specif':625 'exampl':150,488 'exist':183,504,580 'expert':631 'explicit':100,398 'explor':121 'fast':281 'fast-path':280 'faster':601 'file':357,394 'files/components/users':156 'first':194,204 'follow':132,493 'format':517 'friction':296,318 'goal':72 'help':301 'identifi':166 'immedi':267 'implement':9,88 'in/out':158 'includ':278,292,440 'input':640 'insid':275 'inspect':388 'interpret':31,182,426 'keep':195 'key':33,441 'know':310,314 'label':371 'languag':339 'language/runtime':168 'letter':511 'like':447 'limit':602 'line':266 'list':252,412 'look':446 'low':63,295,373,574 'low-frict':294 'low-risk':62,372,573 'make':214 'mark':239 'match':611 'migrat':176 'minim':522 'minimum':75 'miss':70,648 'multipl':29,180,229,594 'multiple-choic':228,593 'must':92,191,348,492 'must-hav':91,190,347 'need':80,308,457 'nice':312 'none':499 'number':223,411,508 'object':35,138 'offer':227 'older':547 'one':481 'open':587 'open-end':586 'optim':219 'option':231,257,299,320,336,512 'os':170 'output':620 'paragraph':226 'pass':205 'path':282 'pattern':562,581 'paus':343 'perform':124,162,368,495 'permiss':641 'pick':480 'plain':338 'plan':362 'plausibl':30,181 'possibl':233 'prefer':206 'present':256 'proceed':102,402,416,428 'produc':359 'project':505,541 'put':262 'question':3,16,79,94,193,201,207,215,224,451,509,566,589 'quick':61,572 'read':66,391,577 'reason':235 'recommend':248,265 'recommended/default':290 'reduc':317 'refactor':526 'relev':392 'repli':285,516,554 'repo':389 'request':27,54,111,116 'requir':7,435,639 'respond':325 'respons':283 'restat':333,433 'review':632 'risk':64,178,374,575 'rollout/rollback':177 'run':354 'runner':172 'safeti':40,642 'safety/reversibility':174 'scannabl':221 'scope':36,154,520,613 'sentenc':439 'separ':307 'serious':12 'set':76 'short':222,410 'skill':24,51,605 'skill-ask-questions-if-underspecified' 'small':197 'source-sickn33' 'specif':627 'start':87,449,455 'state':104,405 'stay':143 'step':376 'stop':633 'structur':319,390 'style':163,496 'substitut':623 'success':445,645 'suggest':234 'support':546 'sure':298,304,533,551 'tag':273 'target':502,538 'task':609 'templat':452 'test':629 'text':518 'tight':592 'time':165 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'touch':528 'treat':114,618 'unclear':42 'underspecifi':5,18,113,118,187 'unknown':366 'use':10,21,22,46,49,305,507,534,552,603 'user':99,323,397 'valid':628 'version':169,494,548 'vs':142 'whether':109 'whole':210 'without':403 'work':84,126,213,450 'workflow':106 'would':483,598 'wrong':83 'yes/no':597","prices":[{"id":"8cb1097b-8f41-4b35-a673-c977ca66a8b8","listingId":"f06dbc10-76ec-49b9-a0df-04a50a9f8d46","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:31:29.561Z"}],"sources":[{"listingId":"f06dbc10-76ec-49b9-a0df-04a50a9f8d46","source":"github","sourceId":"sickn33/antigravity-awesome-skills/ask-questions-if-underspecified","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ask-questions-if-underspecified","isPrimary":false,"firstSeenAt":"2026-04-18T21:31:29.561Z","lastSeenAt":"2026-04-25T00:50:28.577Z"}],"details":{"listingId":"f06dbc10-76ec-49b9-a0df-04a50a9f8d46","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"ask-questions-if-underspecified","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34964,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"87cb426817aaafb42cc585ead9ac0c52dce059b8","skill_md_path":"skills/ask-questions-if-underspecified/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ask-questions-if-underspecified"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"ask-questions-if-underspecified","description":"Clarify requirements before implementing. Use when serious doubts arise."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/ask-questions-if-underspecified"},"updatedAt":"2026-04-25T00:50:28.577Z"}}