ask-user-question

Collect user clarifications via AskUserQuestion and log structured decisions.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill ask-user-question-waterball-software-academy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-user-question
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/clarify-loop/sub-skill/AskUserQuestion
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill ask-user-question-waterball-software-academy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes references (resource) and scripts (resource) components.

What problem does it solve?

This route solves the problem of collecting correct user decisions to resolve ambiguity in a boundary-aware workflow, without falling back to ad-hoc conversation.

Core Features & Use Cases

  • Batch question asking with tool enforcement: Uses AskUserQuestion (or fallback AskQuestion) to present up to four questions per tool call, including an update_mode choice that controls sync vs async behavior.
  • Structured answer parsing and OTHER support: Restores option IDs, supports OTHER with free-text, and logs resolved answers in the required sub-round format.
  • Resolution + sweep-based closing: Resolves updates in sync or dispatches per-question subagents in async, then runs a sticky-note consistency sweep to detect remaining or obsolete requirements.

Quick Start

Ask for the route to clarify user choices in a given round payload and return updated artifacts plus remaining sticky-note status.

Frequently Asked Questions about ask-user-question

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch user clarification questions to resolve ambiguous requirements?

Batch asking user clarification questions involves presenting up to four questions per tool call using AskUserQuestion, enforcing structured deterministic option parsing while supporting free-text follow-ups via OTHER, and logging resolved answers to resolve ambiguous requirements systematically.

What is the best way to parse structured options and free-text follow-ups during spec validation?

Parsing structured options during spec validation requires restoring option IDs and supporting OTHER free-text inputs. The system deterministically parses these structured choices and logs resolved answers in a required sub-round format to maintain accurate workflow automation.

Can I use sync and async routing modes when delegating subagents for requirement updates?

Yes, you can use sync and async routing modes for requirement updates. Sync mode resolves updates directly, while async mode dispatches per-question subagents for delegation, both controlled by an update_mode choice presented during the clarification round.

How do I ensure acceptance criteria correctness after updating workflow requirements?

To ensure acceptance criteria correctness after updating workflow requirements, run a sticky-note consistency sweep. This detects remaining or obsolete requirements using grep_sticky_notes.py, verifying that all structured decisions align with the updated session logs.

Do I need Python to run a sticky-note consistency sweep for workflow automation?

Yes, you need Python3 to run the sticky-note consistency sweep for workflow automation. The sweep relies on the grep_sticky_notes.py script to detect obsolete or remaining requirements after resolving user clarifications in the discovery-to-implementation workflow.