CtrlK
BlogDocsLog inGet started
Tessl Logo

twilio-voice-conversation-relay

Build AI-powered voice agents using Twilio ConversationRelay. Handles real-time speech recognition (ASR), text-to-speech (TTS), and bidirectional audio streaming via WebSocket. Covers TwiML setup, WebSocket message types, LLM integration, streaming responses, and voice provider configuration. Use this skill to build voice bots, IVR replacements, or real-time AI voice assistants on Twilio calls.

69

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

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

A well-structured, actionable reference with executable bilingual code samples and a thorough CANNOT boundary list. It is concise and well-organized, though it lacks explicit validation checkpoints and a couple of setup details are deferred to sibling skills.

DimensionReasoningScore

Conciseness

Largely lean — the Overview diagram and code blocks assume Claude's competence without explaining what a WebSocket or TTS is. One mild instance of over-explanation ('Lower latency by streaming... Twilio starts speaking before the full response is ready') could be trimmed. Not a 5 because of that small piece of justifying prose; not a 3 because the body is predominantly efficient.

4 / 5

Actionability

Provides copy-paste-ready Python and Node.js for TwiML setup, WebSocket handling, token streaming, and voice configuration across the common cases. Not a 5: call_llm/callLLM are unstubbed placeholders and a few parameters (e.g., provisioning a voice number) are referenced out to other skills; not a 3 because the bulk of guidance is genuinely executable.

4 / 5

Workflow Clarity

A clear two-step Quickstart sequence (return TwiML → handle WebSocket/respond) with a security callout on untrusted voicePrompt input. This is a non-destructive setup skill so the batch/destructive cap does not apply. Not a 5: explicit validation checkpoints and error-recovery feedback loops for the setup flow are largely absent; not a 3 because the sequence is coherent and well-ordered.

4 / 5

Progressive Disclosure

Well-organized into Overview, Prerequisites, Quickstart, Key Patterns, CANNOT, and Next Steps, with cross-skill references clearly signaled (e.g., 'see twilio-voice-outbound-calls'). No bundle files exist; the single-file structure is appropriate and navigable. Not a 5: the body is somewhat long for a SKILL.md overview and a few dense reference tables could be candidates for offloading if a bundle were introduced.

4 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

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, well-scoped description that concretely enumerates capabilities and provides an explicit 'Use when' trigger clause tied to Twilio voice use cases. It is comprehensive, third-person, and unlikely to trigger for the wrong skill.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — 'Handles real-time speech recognition (ASR), text-to-speech (TTS), and bidirectional audio streaming' and 'Covers TwiML setup, WebSocket message types, LLM integration, streaming responses, and voice provider configuration' — giving comprehensive coverage of the domain. Not a 4: coverage spans more than several specific actions with no meaningful gaps.

5 / 5

Completeness

Explicitly answers both 'what' ('Build AI-powered voice agents... Handles ASR, TTS, audio streaming... Covers TwiML setup, WebSocket message types, LLM integration') and 'when' ('Use this skill to build voice bots, IVR replacements, or real-time AI voice assistants on Twilio calls') with concrete trigger phrases. Not a 4: the 'when' clause is explicit and concrete, not merely present.

5 / 5

Trigger Term Quality

Includes natural user phrases like 'voice bots', 'IVR replacements', 'AI voice assistants', 'speech recognition', and 'text-to-speech'. Not a 5: a few natural synonyms/variants (e.g., 'telephony bot', 'phone agent') are absent; not a 3 because keyword coverage is genuinely good with multiple natural terms.

4 / 5

Distinctiveness Conflict Risk

Carves a clear niche around Twilio ConversationRelay with triggers tied specifically to Twilio calls, minimizing overlap with adjacent skills. Not a 4: the 'Twilio ConversationRelay' / 'Twilio calls' scoping leaves minimal conflict risk with other skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
openai/plugins
Reviewed

Table of Contents

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.