telephony

Provision and persist a Twilio number for SMS, MMS, and calls.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill telephony-yangel-hide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telephony
Source: https://github.com/Yangel-hide/video-production-planner-agent/tree/main/optional-skills/productivity/telephony
Command: npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill telephony-yangel-hide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) components.

What problem does it solve?

Provision Hermes with practical phone capabilities by provisioning and persisting a Twilio number for SMS/MMS, direct calls, and AI-driven outbound calls through Bland.ai or Vapi.

Core Features & Use Cases

  • Provision and persist a Twilio number, including saving credentials and the number SID.
  • Send SMS/MMS from the owned number and poll inbound messages without requiring a webhook server.
  • Make direct Twilio calls or AI-driven calls via Bland.ai or Vapi, with optional TTS or prerecorded messages.
  • Maintain a reusable agent phone identity across sessions and workflows.
  • Local state is stored at ~/.hermes to remember the default number and IDs across sessions.

Quick Start

Install the telephony skill, configure credentials for Twilio and optional Bland.ai or Vapi, then run the helper script to search for or buy a number and begin texting or calling.

Frequently Asked Questions about telephony

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

FAQPage Schema
How do I provision a Twilio number for SMS and AI calls without a webhook server?

Provision a Twilio number for SMS and AI calls without a webhook server by using this skill to buy, persist, and poll the number locally. State is saved at ~/.hermes to track owned numbers and IDs across sessions.

Can I make AI-driven outbound calls using Bland.ai or Vapi through Twilio?

Yes, you can make AI-driven outbound calls using Bland.ai or Vapi through Twilio. The skill integrates with these optional AI call providers to automate outbound telephony workflows alongside direct Twilio calls.

Do I need Twilio credentials to send MMS and SMS messages through this setup?

Yes, you need Twilio credentials to send MMS and SMS messages through this setup. You must also provide optional Bland.ai or Vapi API keys if you plan to use AI-driven outbound calling features.

What is the best way to maintain a reusable phone identity across different sessions?

The best way to maintain a reusable phone identity across different sessions is by persisting the Twilio number SID and credentials locally. The skill stores this default number state at ~/.hermes for continuous access.

Does telephony support polling inbound SMS messages instead of setting up webhooks?

Yes, telephony supports polling inbound SMS messages instead of setting up webhooks. This allows you to retrieve incoming messages directly without requiring a live webhook server for your Hermes workflows.

What are the limitations of using local state at ~/.hermes for managing Twilio numbers?

A limitation of using local state at ~/.hermes for managing Twilio numbers is that your owned number SIDs and IDs are tied to the local machine. If this directory is deleted, your persisted telephony session data is lost.