Useuser (Agent Skill)

An Agent Skill that enables AI agents to ask humans questions through native macOS dialogs.

What is this?

This is an Agent Skill - a folder of instructions and scripts that AI agents can use to extend their capabilities. When installed, agents can show native macOS dialogs to:

• Ask text input questions
• Present multiple choice options
• Get yes/no confirmations
• Display information requiring acknowledgment
• Send system notifications

Installation

Install via the skills CLI:

npx skills add willwillems/useuser

This will download and configure the skill for use with your AI agent.

Requirements

• macOS only - Uses AppleScript for native dialogs
• A skills-compatible AI agent (Claude Code, Cursor, etc.)

Dialog Types

Text Input

scripts/ask_text.sh "What's the API endpoint?" "https://api.example.com" 300

Multiple Choice

scripts/ask_choice.sh "Which database?" "PostgreSQL" "MySQL" "SQLite"

Yes/No Confirmation

scripts/ask_confirm.sh "Delete these files?" "no" 300

Information Display

scripts/show_info.sh "Operation completed successfully!"

Notification

scripts/notify.sh "Build complete" "Dev Server" "Ready to test" "yes"

How It Works

1. Agent encounters uncertainty or needs confirmation
2. Agent runs the appropriate dialog script
3. Native macOS dialog appears
4. User responds
5. Agent receives the response and continues

No complex setup, no server processes - just scripts that show dialogs.

Documentation

See SKILL.md for complete documentation including:

• Detailed parameter descriptions
• Usage examples
• Error handling patterns
• Best practices

License

MIT - See LICENSE