Guide · Agent skill
How to use the Voice Call agent skill: setup, commands and tips
Updated · written with AI from the project's own documentation and checked against our catalogue data
The voice-call skill teaches an AI agent how to place outgoing phone calls and check on them using the Brigade voice-call plugin. This guide explains what the skill does, how to install it, how to trigger it with plain requests and what you need before any call can reach a real phone. By the end you will be able to set it up, make a test call safely and know which safety settings matter.
Voice Callspinabot/brigade · MIT Download the skill Quick start
- 1Enable the voice-call plugin. Confirm that plugins.entries.voice-call.enabled is set in your Brigade configuration.
- 2Choose a provider. Pick Twilio, Telnyx or Plivo, or use the mock provider for testing without network access.
- 3Add provider credentials. Fill in the required keys under plugins.entries.voice-call.config, including fromNumber.
- 4Download and unzip the skill. Download the voice-call ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder.
- 5Test with the mock provider. Set provider to mock so you can confirm the flow without placing a real call.
- 6Run a CLI test call. Run brigade voicecall call with a number you are allowed to call and a short message, then check it with brigade voicecall status.
- 7Ask the agent in plain language. Once the CLI works, make a natural request and confirm the agent uses the voice_call tool as expected.
What is an agent skill, and what does voice-call let the agent do?
An agent skill is a folder containing a SKILL.md file that gives an AI agent instructions for one specific task. When the skill is installed, the agent reads these instructions and knows how to carry out that task when you ask for it.
The voice-call skill covers placing and managing phone calls. Through the Brigade voice-call plugin, the agent can start a call with a spoken message, continue or end an active call, speak to the user on an existing call and report a call's status. It can do this through a command-line tool or a built-in calling action.
- Start an outgoing call with a spoken message
- Continue an active call with a further message
- Speak to the user on a call that is already running
- End a call by its call ID
- Check the status of a call by its call ID
What you need before installing voice-call
The skill only works inside a Brigade setup with the voice-call plugin enabled. The config key it checks is plugins.entries.voice-call.enabled.
You also need a telephony provider. The skill supports Twilio, Telnyx and Plivo, and each needs its own credentials and a fromNumber. If you only want to test, you can use the mock provider, which makes no network calls and places no real calls.
- Brigade with the voice-call plugin enabled (plugins.entries.voice-call.enabled)
- Twilio: accountSid, authToken and fromNumber
- Telnyx: apiKey, connectionId and fromNumber
- Plivo: authId, authToken and fromNumber
- Or the mock provider for testing without network access
How do you install the voice-call skill?
Download the ZIP for voice-call from this page. Unzip it into one of two places: ~/.claude/skills/ to make the skill available to you across projects, or a project's .claude/skills/ folder to limit it to that project.
If you use the Claude apps instead, open Settings, go to Capabilities, then Skills, and upload the ZIP there.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
How do you configure a telephony provider?
Plugin settings live under plugins.entries.voice-call.config. Set the provider field to twilio, telnyx or plivo, then fill in the credentials for that provider along with fromNumber. The mock provider is set with provider: "mock" and is intended as a development fallback that uses no network.
Keep credentials out of shared files and screenshots. Use a test setup until you have confirmed the call flow works as you expect.
- Twilio: provider "twilio" with twilio.accountSid, twilio.authToken and fromNumber
- Telnyx: provider "telnyx" with telnyx.apiKey, telnyx.connectionId and fromNumber
- Plivo: provider "plivo" with plivo.authId, plivo.authToken and fromNumber
- Dev fallback: provider "mock" (no network)
How do you make a call from the command line?
The skill documents two CLI commands. The first starts a call to a number with a message. The second checks a call using its ID. Replace the example number with one you are allowed to call.
The command-line form is useful for checking that your provider settings work before you let an agent use them.
brigade voicecall call --to "+15555550123" --message "Hello from Brigade"
brigade voicecall status --call-id <id>How do you trigger the skill with natural requests?
You do not need special syntax. Ask the agent in plain language, naming the number and the message. The skill's tool is called voice_call, and the agent uses it for calls it starts itself.
The tool supports these actions: initiate_call (message, to optional, mode optional), continue_call (callId, message), speak_to_user (callId, message), end_call (callId) and get_status (callId). You will rarely need to name them; the agent chooses the right one from your request.
Example requests you might give: "Call +15555550123 and say the delivery window has moved to 3pm." "Check the status of the call you just started." "End the active call."
- Name the number in full, including the country code
- State the exact message you want spoken
- Give the call ID when asking about or ending an existing call
What people use it for
- Sending a short automated reminder or notification to a phone number
- Letting an agent phone a number with a single prepared message
- Checking the status of a call that is already in progress
- Testing a call flow end to end with the mock provider before using a live account
Frequently asked questions
How do I install the voice-call skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can instead upload the ZIP under Settings → Capabilities → Skills.
What do I need to use the voice-call skill?
You need Brigade with the voice-call plugin enabled, plus a telephony provider account: Twilio, Telnyx or Plivo. For testing without network access, you can use the mock provider instead.
Is the voice-call skill free?
The skill is licensed under MIT. Real calls go through your own telephony provider account, and the source does not state pricing, so check your provider's terms for any charges.
Does the skill place real phone calls?
Yes, if you configure Twilio, Telnyx or Plivo. The mock provider makes no real calls and no network requests, so use it when you want to test.
Which telephony providers does voice-call support?
The source lists Twilio, Telnyx and Plivo, plus a mock provider for development. Each real provider needs its own credentials and a fromNumber.
Why isn't my voice call skill working?
Check first that the voice-call plugin is enabled under plugins.entries.voice-call.enabled. Then confirm the provider field matches the credentials you filled in, and try the mock provider to separate configuration problems from network or account problems.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
The voice-call skill suits developers and operators who want an agent to place short automated calls through Brigade, especially if they test with the mock provider first. It is not a good fit if you do not want an agent placing real calls, if calls must be reviewed before they go out, or if you have no Twilio, Telnyx or Plivo account.
Download the skill