Useuser

This skill enables you to ask humans questions through native macOS system dialogs. Use this when you need direct user input, confirmation before taking actions, or want to display important information that requires acknowledgment.

When to Use This Skill

• Clarification needed: When you're uncertain about requirements or need more context
• Confirmation required: Before performing destructive or irreversible actions
• User preferences: When you need to know which option the user prefers
• Important notifications: When you need to alert the user about something significant
• Blocking questions: When you cannot proceed without user input

Available Dialog Types

1. Text Input Dialog

Ask open-ended questions where the user types a response.

scripts/ask_text.sh "What is the database connection string?" "postgresql://localhost:5432/mydb" 300

Parameters:

• $1 - Question text (required)
• $2 - Default value (optional, defaults to empty)
• $3 - Timeout in seconds (optional, defaults to 300). Use 0 or none for no timeout.

Returns: The text entered by the user, or "CANCELLED" if cancelled, or "TIMEOUT" if timed out.

No timeout example:

scripts/ask_text.sh "What is your preferred username?" "" 0

2. Multiple Choice Dialog

Present a list of options for the user to choose from.

scripts/ask_choice.sh "Which authentication method should I use?" "OAuth2" "JWT" "Session-based" "API Keys"

Parameters:

• $1 - Question/prompt text (required)
• $2+ - Available choices (at least 2 required)

Returns: The selected choice text, or "CANCELLED" if cancelled.

3. Yes/No Confirmation Dialog

Get a simple yes or no answer.

scripts/ask_confirm.sh "Should I delete the old migration files?" "no" 300

Parameters:

• $1 - Question text (required)
• $2 - Default button: "yes" or "no" (optional, defaults to "no")
• $3 - Timeout in seconds (optional, def...