charlieviettq/awesome-agent-skill / .claude/skills/clarify-underspecified
clarify-underspecified
VerifiedAsk the minimum clarifying questions before implementing when scope, constraints, or success criteria are unclear. Use when a request has multiple plausible interpretations, missing acceptance criteria, or ambiguous environment constraints.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.5 KB |
SKILL.md
View on GitHub---
name: clarify-underspecified
description: "Ask the minimum clarifying questions before implementing when scope, constraints, or success criteria are unclear. Use when a request has multiple plausible interpretations, missing acceptance criteria, or ambiguous environment constraints."
allowed-tools: Read, Glob, Grep
---
# Clarify underspecified requests
## When to use
- Multiple plausible interpretations exist.
- Objective, scope, constraints, or "done" criteria are missing.
- Quick read-only discovery cannot resolve the ambiguity.
## When not to use
- Request is already specific enough to proceed.
- A short repo/config read answers the open questions.
## Workflow
1. Decide if the request is underspecified (objective, scope, constraints, environment, safety).
2. Ask **1-5** questions max; prefer multiple-choice with a `defaults` fast path.
3. Separate **need to know** vs **nice to know**.
4. Do not run mutating commands or commit to a detailed plan until must-have answers arrive.
5. If the user asks to proceed without answers, state assumptions explicitly and get confirmation.
## Question format
```text
1) Scope?
a) Minimal change (default)
b) Broader refactor in the same area
c) Not sure - use default
Reply: defaults (or 1a 2b)
```
## Anti-patterns
- Do not ask what a quick read of repo/docs already answers.
- Do not ask open-ended questions when a yes/no or A/B choice is faster.
## Output
Restate requirements in 1-3 sentences (constraints + success criteria), then start work.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |