Co-Pilot
Updated a month ago

ask-questions-if-underspecified

Ttrailofbits
1.8k
trailofbits/skills/plugins/ask-questions-if-underspecified
76
Agent Score

💡 Summary

An AI agent skill that asks clarifying questions when user requests are ambiguous to prevent incorrect work.

🎯 Target Audience

AI Agent DevelopersProduct Managers defining agent workflowsTechnical Support Bot BuildersQuality Assurance Engineers

🤖 AI Roast:This skill is essentially a professional rubber duck that charges by the question.

Security AnalysisLow Risk

Primary risk is prompt injection via user answers, potentially steering the agent's subsequent actions. Mitigation: Implement input validation and sanitization on the answers before they are processed by downstream skills.

Ask Questions If Underspecified

Ask the minimum set of clarifying questions needed to avoid wrong work.

Author: Kevin Valerio

When to Use

Use this skill when:

  • The request has multiple plausible interpretations
  • Success criteria, scope, constraints, or environment details are unclear
  • Starting implementation without clarification risks doing the wrong work

What It Does

  • Asks 1–5 must-have questions in a scannable, answerable format (multiple choice + defaults)
  • Pauses before acting until required answers are provided (unless the user approves proceeding on stated assumptions)
  • Restates confirmed requirements before starting work

Installation

/plugin install trailofbits/skills/plugins/ask-questions-if-underspecified
5-Dim Analysis
Clarity8/10
Novelty6/10
Utility9/10
Completeness7/10
Maintainability8/10
Pros & Cons

Pros

  • Prevents wasted effort from misinterpreted tasks.
  • Improves output quality by ensuring requirements are clear.
  • Simple, focused scope with a clear trigger condition.

Cons

  • May introduce friction if overused on simple tasks.
  • Relies on user being available to answer questions promptly.
  • Limited novelty as a basic interaction pattern.

Related Skills

mcp-builder

S
toolCode Lib
90/ 100

“This guide is so comprehensive it might just teach the AI to write its own MCP servers and put you out of a job.”

learn-claude-code

A
toolCode Lib
88/ 100

“A tutorial that finally admits its own past mistakes is more honest than most, but still can't resist the classic 'one weird loop' oversimplification.”

connect

A
toolAuto-Pilot
86/ 100

“It's the ultimate 'I'll do it for you' skill, turning Claude from a thoughtful advisor into an over-eager intern with access to all your accounts.”

Disclaimer: This content is sourced from GitHub open source projects for display and rating purposes only.

Copyright belongs to the original author trailofbits.