Skip to main content
Plivo publishes a skill for AI coding agents such as Claude Code, Cursor and Codex. Install it once, and your agent knows how to write and fix the XML your answer URL returns: which element does what, what may nest inside what, which URL receives which parameters, and why a call failed with 8011 or 8012. A skill is a set of instructions your agent loads on its own when the task matches, so you keep working the way you already do.

​
Install

That installs into every coding agent it finds. To pick one:
Skills install at project scope by default, which puts them in your repository so teammates and cloud agents get the same setup. Add --global to install once for every project. Any tool that follows the Agent Skills standard reads the same file.

​
Read it before you install

The skill is a plain Markdown file. Open it yourself, or give the URL to your agent.

plivo-voice-xml

The full skill file, published from this documentation site.
Every Plivo skill is listed in the skills index, with a SHA-256 digest so your agent can verify what it downloaded.

​
What is in the skill

​
What the agent does with it

  1. Asks what the call should do before writing anything, because the same flow written two ways behaves differently.
  2. Writes valid XML the first time, with the right attributes and the ordering rules applied, instead of XML that parses but misbehaves.
  3. Explains what each URL will receive, so your handler reads the right parameters and validates the signature.
  4. Diagnoses a failed call from its code. It maps 8011 or 8012 to the shape that causes it and names the fix, rather than guessing at your XML.

​
What it will not do

  • It does not cover WebSocket voice bots. For <Stream>, use the Audio Streaming skill.
  • It does not cover AI platforms connected over SIP. For LiveKit, ElevenLabs, Retell or Vapi, use the SIP trunking skill.
  • It does not cover SMS, WhatsApp or the browser SDK.
  • It does not invent elements or attributes. Where the documentation does not answer a question, it says so instead of guessing.
  • It cannot see your account or your server. It works on the XML and tells you what to check.

​
Verify it is working

In the project where you installed it, ask your agent:
My IVR plays the greeting but the keypad menu never fires. Here is my XML.
You should get a check of the element ordering and the action URL before anything else, with the specific rule that applies, not general XML advice. If you get generic advice with no reference to Plivo elements, the skill did not load.

​
Keeping it current

The published skill tracks this documentation. Your local copy does not update itself:
An installed skill runs with your agent’s permissions. Read the file before installing it, and treat a skill from a source you do not trust the way you would treat a shell script.

XML overview

The same material for a human reader

Audio Streaming skill

For WebSocket voice bots

SIP trunking skill

For LiveKit, ElevenLabs, Retell and Vapi

Plivo CLI

Make calls and debug them from the terminal