twilio-voice-twiml

Build voice call logic using TwiML (Twilio Markup Language). Covers the core verbs (Say, Play, Gather, Dial, Record, Conference), generating TwiML with Python and Node.js SDKs, and a complete inbound call IVR example. Use this skill to define call behavior for inbound or outbound calls.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Quality

Content

92%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An action-dense, executable reference with excellent conciseness and actionability and clearly sequenced call flows. Its main weakness is progressive disclosure: no references/ directory exists, so all per-verb detail lives inline in a single large file.

Suggestions

Add a references/ directory and move the per-verb Python+Node deep dives (Say, Gather, Play, Dial, Record, Conference, Pay) into one-level-deep files like VERBS.md, keeping SKILL.md as an overview that links to them.

Introduce an explicit validation checkpoint in the Production Deployment section — e.g. a curl command to POST a sample TwiML payload and assert a 200 with Content-Type: text/xml before going live.

The 'Webhook Request Parameters' table could move into a reference file (e.g. WEBHOOKS.md) so the core call-behavior guidance in SKILL.md stays lean.

Dimension	Reasoning	Score
Conciseness	Lean and efficient: it never explains what XML/webhooks/SDKs are and jumps straight to executable code; per-verb boilerplate is justified by the rubric's 'executable and complete' requirement rather than padding.	3 / 3
Actionability	Provides fully executable Python and Node.js snippets for every verb, concrete deployment options, specific Console paths, and a webhook parameter table — copy-paste ready.	3 / 3
Workflow Clarity	The multi-step IVR (gather -> menu-choice -> dial/redirect) and voicemail (dial with action -> Record handler -> recording-complete) flows are clearly sequenced; as a reference catalog of unambiguous single actions it does not require destructive/batch validation checkpoints.	3 / 3
Progressive Disclosure	Internally well-organized with clear section headers and well-signaled 'Next Steps' pointers, but it is a ~350-line monolithic file with no bundle files at all; per-verb deep dives that could be offloaded to references remain inline.	2 / 3
	Total	11 / 12 Passed

Description

100%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that names concrete capabilities, includes natural trigger terms, and provides an explicit 'Use this skill to...' clause covering both what and when. It is clearly distinguishable from adjacent Twilio skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Covers the core verbs (Say, Play, Gather, Dial, Record, Conference)', 'generating TwiML with Python and Node.js SDKs', and 'a complete inbound call IVR example' — rather than vague language.	3 / 3
Completeness	Clearly answers 'what' (build voice call logic with TwiML, core verbs, SDKs, IVR example) and 'when' via the explicit trigger 'Use this skill to define call behavior for inbound or outbound calls'.	3 / 3
Trigger Term Quality	Uses natural terms a user would say — 'voice call logic', 'TwiML', 'inbound call IVR', and 'inbound or outbound calls' — giving good coverage of likely phrasings.	3 / 3
Distinctiveness Conflict Risk	Occupies a clear niche (TwiML voice call logic) with distinct triggers unlikely to collide with other skills; the outbound/conversation-relay overlap is explicitly deferred to sibling skills in the body.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: openai/plugins
Path: plugins/twilio-developer-kit/skills/twilio-voice-twiml/SKILL.md
Commit: 11c74d6

Reviewed: 17 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.