azure-ai-voicelive-py

Build real-time voice AI applications with bidirectional WebSocket communication.

Quality

48%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/azure-ai-voicelive-py/SKILL.md

Quality

Discovery

32%

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

The description identifies a clear domain (real-time voice AI with WebSockets) but is too terse to be effective for skill selection. It lacks a 'Use when...' clause, specific concrete actions, and natural trigger terms that users would employ when requesting this kind of help.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user wants to build voice assistants, real-time audio streaming apps, or speech-to-text/text-to-speech pipelines over WebSockets.'

List specific concrete actions such as 'stream audio input/output, handle turn-taking, integrate with speech recognition and synthesis APIs, manage WebSocket connections for low-latency voice interactions.'

Include natural keyword variations users might say: 'voice assistant', 'audio streaming', 'speech-to-text', 'TTS', 'STT', 'conversational AI', 'real-time audio'.

Dimension	Reasoning	Score
Specificity	Names the domain ('voice AI applications') and a key technical approach ('bidirectional WebSocket communication'), but does not list multiple concrete actions like 'stream audio', 'handle turn-taking', 'transcribe speech', etc.	2 / 3
Completeness	Describes what the skill does at a high level but completely lacks a 'Use when...' clause or any explicit trigger guidance, which per the rubric caps completeness at 2, and the 'what' itself is also not very detailed, placing it at 1.	1 / 3
Trigger Term Quality	Includes relevant terms like 'voice AI', 'real-time', and 'WebSocket', but misses common user variations such as 'speech-to-text', 'audio streaming', 'voice assistant', 'STT', 'TTS', or 'conversational AI'.	2 / 3
Distinctiveness Conflict Risk	The combination of 'voice AI' and 'WebSocket' is fairly specific, but without more concrete triggers it could overlap with general WebSocket skills or general voice/audio processing skills.	2 / 3
	Total	7 / 12 Passed

Implementation

64%

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

This is a solid, actionable skill with comprehensive executable code examples covering the full lifecycle of Azure AI Voice Live SDK usage. Its main weaknesses are moderate verbosity from duplicated code patterns and inline reference tables that could be offloaded to supporting files, plus a lack of explicit validation/verification steps in the workflow. The referenced bundle files are missing, undermining the progressive disclosure structure.

Suggestions

Move the voice options table, audio formats table, and turn detection options into the referenced references/models.md file to reduce SKILL.md length and improve progressive disclosure.

Remove the duplicate connection code between Authentication and Quick Start sections—keep one canonical example and reference it.

Add a validation step after session.update() (e.g., check for session.updated event) before proceeding to audio streaming, to establish a proper workflow checkpoint.

Remove the generic 'When to Use' and 'Limitations' boilerplate sections that add no skill-specific value.

Dimension	Reasoning	Score
Conciseness	The skill is mostly efficient with good code examples, but there's redundancy—the Quick Start section largely duplicates the Authentication section's DefaultAzureCredential example. The voice options table and audio formats table add reference bulk that could be in a separate file. The boilerplate 'When to Use' and 'Limitations' sections add no value.	2 / 3
Actionability	The skill provides fully executable, copy-paste ready code examples throughout—connection setup, session configuration, audio streaming, event handling, function calls, error handling. All examples use real imports, real method signatures, and concrete parameters.	3 / 3
Workflow Clarity	The skill covers many patterns clearly (manual turn mode, interrupt handling, function call responses), but lacks explicit validation checkpoints. For a real-time WebSocket application involving audio streaming, there's no guidance on verifying connection health, validating audio format compatibility, or confirming session setup succeeded before proceeding to stream audio.	2 / 3
Progressive Disclosure	References to api-reference.md, examples.md, and models.md are listed at the bottom, but no bundle files were provided to verify they exist. The main file is quite long (~250 lines) with reference tables (voices, audio formats) that would be better placed in the referenced files, keeping the SKILL.md as a leaner overview.	2 / 3
	Total	9 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: sickn33/antigravity-awesome-skills
Commit: 76aea27

Reviewed: 18 minutes 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.