make-phone-call

Initiate phone calls with text-to-speech messages using the Twilio API. Use this skill when the user asks to make a phone call, call someone, initiate a call, or send a voice message to a phone number. Supports custom message content and any recipient number in E.164 format.

First seen Mar 1, 2026

Installation

$ npx skills add dalehurley/phpbot --skill make-phone-call

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Repository health

Stars 2

License MIT

Default branch main

Open issues 0

Status Active

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 3,731 B

docs SUMMARY.md 298 B

History

Mar 1, 2026 First seen on skills.sh

Sep 9, 2026 First recorded snapshot · 5 installs

SKILL.md

Skill: make-phone-call

Overview

This skill uses the Twilio API to programmatically initiate outbound phone calls with text-to-speech messages. The call is queued immediately and the recipient will hear the message read aloud when they answer.

When to Use

Use this skill when the user asks to:

Make a phone call
Call someone
Initiate an outbound call
Send a voice message
Notify someone via phone call
Leave a voice message

Required Credentials

Retrieve these via the get_keys tool before executing:

Key Store Key	Environment Variable	Description
`twilioaccountsid`	`TWILIOACCOUNTSID`	Your Twilio Account SID for API authentication
`twilioauthtoken`	`TWILIOAUTHTOKEN`	Your Twilio Auth Token for API authentication
`twiliophonenumber`	`TWILIOPHONENUMBER`	Your Twilio phone number to send calls from

Twilio Setup

Create a Twilio account at twilio.com
Verify your identity and get your Account SID and Auth Token from the Console dashboard
Purchase or verify a phone number for making outbound calls
Store credentials in the key store: twilioaccountsid, twilioauthtoken, twiliophonenumber

Input Parameters

Parameter	Required	Description	Example
`recipientphonenumber`	Yes	The phone number to call in E.164 format	{{PHONE_NUMBER}}
`message_text`	Yes	The message to be read aloud via text-to-speech	hey buddy

Procedure

Retrieve Twilio credentials using getkeys with keys [twilioaccountsid, twilioauthtoken, twiliophone_number]
Get the recipient phone number and message content from the user if not provided (use ask_user)
Validate phone numbers are in E.164 format (e.g., {{PHONE_NUMBER}})
Install Twilio Node.js package if not already present: npm install twilio
Create and execute the call script using bundled make_call.js with recipient number and message text
Verify the response contains a Call SID indicating successful queue
Report call status and SID to the user

Output

A confirmation message containing the Call SID, recipient number, sender number, message text, and call status (queued).

Bundled Scripts

Script	Type	Description
`scripts/make_call.js`	JS	Auto-captured from task execution

Credentials in scripts use environment variables. Set them via get_keys before running.

Reference Commands

Commands for executing this skill (adapt to actual inputs):

npm install twilio
node make_call.js {{RECIPIENT_PHONE}} {{MESSAGE_TEXT}}

Replace {{PLACEHOLDER}} values with actual credentials from the key store.

Example

Example requests that trigger this skill:

make a phone call to confirm the appointment

Notes

Phone numbers must be in E.164 format (e.g., {{PHONE_NUMBER}} for US numbers)
Twilio trial accounts can only call verified phone numbers
The call is queued immediately; actual connection may take a few seconds
Text-to-speech voice is set to 'alice' by default
Ensure the Twilio phone number has outbound calling permissions enabled

Keywords

call, phone, voice, twilio, outbound, text-to-speech, tts, notify