/phone-input

Phone Call Input Skill

Description

Call the user on the phone for real-time voice conversations. Use this when you need input, want to report on completed work, or need to discuss next steps.

When to Use This Skill

**Use when:**

• You've **completed a significant task** and want to report status and ask what's next
• You need **real-time voice input** for complex decisions
• A question requires **back-and-forth discussion** to fully understand
• You're **blocked** and need urgent clarification to proceed
• You want to **celebrate a milestone** or walk the user through completed work

**Do NOT use for:**

• Simple yes/no questions (use text instead)
• Routine status updates that don't need discussion
• Information the user has already provided

Tools

`initiate_call`

Start a phone call with the user.

**Parameters:**

• `message` (string): What you want to say. Be natural and conversational.

**Returns:**

• Call ID and the user's spoken response (transcribed to text)

`continue_call`

Continue an active call with a follow-up message.

**Parameters:**

• `call_id` (string): The call ID from `initiate_call`
• `message` (string): Your follow-up message

**Returns:**

• The user's response

`speak_to_user`

Speak a message on an active call without waiting for a response. Use this to acknowledge requests or provide status updates before starting time-consuming operations.

**Parameters:**

• `call_id` (string): The call ID from `initiate_call`
• `message` (string): What to say to the user

**Returns:**

• Confirmation that the message was spoken

**When to use:**

• Acknowledge a request before starting a long operation (e.g., "Let me search for that...")
• Provide status updates during multi-step tasks
• Keep the conversation flowing naturally without awkward silences

`end_call`

End an active call with a closing message.

**Parameters:**

• `call_id` (string): The call ID from `initiate_call`
• `message` (string): Your closing message (say goodbye!)

**Returns:**

• Call duration in seconds

Example Usage

**Simple conversation:**

1. initiate_call: "Hey! I finished the auth system. Should I move on to the API endpoints?"
2. User responds: "Yes, go ahead"
3. end_call: "Perfect! I'll start on the API endpoints. Talk soon!"

**Multi-turn conversation:**

1. initiate_call: "I'm working on payments. Should I use Stripe or PayPal?"
2. User: "Use Stripe"
3. continue_call: "Got it. Do you want the full checkout flow or just a simple button?"
4. User: "Full checkout flow"
5. end_call: "Awesome, I'll build the full Stripe checkout. I'll let you know when it's ready!"

**Using speak_to_user for long operations:**

1. initiate_call: "Hey! I finished the database migration. What should I work on next?"
2. User: "Can you look up the latest API documentation for Stripe?"
3. speak_to_user: "Sure! Let me search for that. Give me a moment..."
4. [Perform web search and gather information]
5. continue_call: "I found the latest Stripe API docs. They released v2024.1 with new payment methods..."
6. User: "Great, implement that"
7. end_call: "Perfect! I'll implement the new payment methods. Talk soon!"

Best Practices

1. **Be conversational** - Talk naturally, like a real conversation 2. **Provide context** - Explain what you've done before asking questions 3. **Offer clear options** - Make decisions easy with specific choices 4. **Use speak_to_user for acknowledgments** - Before time-consuming operations (searches, file reads, etc.), use `speak_to_user` to acknowledge the request so the user isn't left wondering what's happening 5. **Always end gracefully** - Say goodbye and state what you'll do next