ask-user-question

Generates structured JSON form schemas to ask users clarifying questions.

8|2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/luojiaaoo/xpeech --skill ask-user-question-luojiaaoo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ask-user-question
Source: https://github.com/luojiaaoo/xpeech/tree/main/xpeech/agent/skills/buildin/ask-user-question
Command: npx skills add https://github.com/luojiaaoo/xpeech --skill ask-user-question-luojiaaoo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an AI agent lacks the information needed to complete a task, it often guesses or stalls. This Skill lets the agent proactively ask the user for missing details through a structured form instead of unstructured back-and-forth chat. ## Core Features & Use Cases - Structured Form Generation: Builds a JSON form object combining input fields, single-select, multi-select, date, and datetime pickers. - Low-Effort User Input: Prefers select and multi-select controls over free text to reduce user typing cost. - Use Case: A user asks the agent to draft a project plan but gives no deadline or scope. The agent invokes this Skill to present a form asking for task type, required sections, and a target completion date before proceeding. ## Quick Start Ask the user which task type, required sections, and deadline apply before starting the task.

Frequently Asked Questions about ask-user-question

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

FAQPage Schema
How do I make an AI agent ask clarifying questions?▼

Use a structured form approach where the agent emits a JSON object describing fields such as selects, inputs, and date pickers, then renders it for the user. This Skill defines that schema and passes it through the ask_user_question tool.

What field types does the question form support?▼

The form supports five field types: input for free text, select for single choice, multi_select for multiple choices, date for a calendar day, and datetime for a specific point in time. Fields can be combined in one form.

How many questions should be asked at once?▼

The Skill recommends 1 to 5 fields per form and only asking for information strictly required to complete the task. Select and multi-select controls are preferred over free-text inputs to reduce user effort.

What naming rules apply to form field names?▼

Field names must be lowercase English with underscores, matching the pattern ^[a-z][a-z0-9_]*$. This keeps submitted answers machine-readable and consistent for downstream task processing.

When should the agent not ask the user questions?▼

The agent should not ask when the missing information can be reasonably inferred from conversation context. The Skill triggers only when required details are genuinely unavailable and guessing would risk incorrect task execution.