ask-questions-if-underspecified

ask questions if underspecified

trailofbits 6.2k ↓ 6.5k CC-BY-SA-4.0 updated 28d ago
Claude Code
View source ↗

What it does

  • 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)
  • Optimize for scannability (short, numbered questions; avoid paragraphs)

Requirements & configuration

  • Separate "Need to know" from "Nice to know" if that reduces friction
  • Do not run commands, edit files, or produce a detailed plan that depends on unknowns
  • "Before I start, I need: (1) ..., (2) ..., (3) .... If you don't care about (2), I will assume ...."

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

ask questions if underspecified

Source

Repository: https://github.com/trailofbits/skills

ask-questions-if-underspecified FAQ

What does the ask-questions-if-underspecified skill do?

Clarify requirements before implementing. Use when serious doubts arise. Define the objective (what should change vs stay the same) Define "done" (acceptance criteria, examples, edge cases)

What does ask-questions-if-underspecified require?

Separate "Need to know" from "Nice to know" if that reduces friction Do not run commands, edit files, or produce a detailed plan that depends on unknowns "Before I start, I need: (1) ..., (2) ..., (3) .... If you don't care about (2), I will assume ...."

How do I install ask-questions-if-underspecified?

Run: npx -y skills add https://github.com/trailofbits/skills --skill ask-questions-if-underspecified --agent claude-code — the source lives at github.com/trailofbits/skills.

Maintain ask-questions-if-underspecified?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

ask-questions-if-underspecified on getagentictools
[![ask-questions-if-underspecified on getagentictools](https://getagentictools.com/badge/skills/trailofbits-skills-ask-questions-if-underspecified.svg)](https://getagentictools.com/skills/trailofbits-skills-ask-questions-if-underspecified?ref=badge)
npx agentictools info skills/trailofbits-skills-ask-questions-if-underspecified

The second line is the CLI lookup for this page — handy in READMEs and docs.