azure-ai-voicelive-java
Azure AI VoiceLive SDK for Java. Real-time bidirectional voice conversations with AI assistants using WebSocket.
61
52%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/azure-ai-voicelive-java/SKILL.mdQuality
Discovery
40%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 specific technology (Azure AI VoiceLive SDK for Java) which makes it distinctive, but it reads more like a tagline than a functional skill description. It lacks explicit trigger guidance ('Use when...') and doesn't enumerate the concrete actions or tasks the skill enables, making it harder for Claude to know when to select it.
Suggestions
Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user asks about Azure AI VoiceLive, real-time voice streaming in Java, or building voice-based AI assistants with WebSocket.'
List specific concrete actions the skill covers, such as 'Set up WebSocket connections, configure voice pipelines, handle audio streaming, manage conversation sessions, and troubleshoot connectivity issues.'
Include additional natural trigger terms users might say, such as 'speech', 'audio streaming', 'voice chat SDK', 'Azure voice API', or 'real-time audio'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Azure AI VoiceLive SDK for Java) and mentions a key capability (real-time bidirectional voice conversations with AI assistants using WebSocket), but doesn't list multiple concrete actions like setup, configuration, streaming, error handling, etc. | 2 / 3 |
Completeness | Describes what the skill is about but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'what' is also only moderately detailed, this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Azure AI', 'VoiceLive', 'Java', 'WebSocket', 'voice conversations', and 'real-time', but misses common user variations like 'speech', 'audio streaming', 'voice chat', 'Azure Communication Services', or 'SDK integration'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'Azure AI VoiceLive SDK', 'Java', and 'WebSocket' creates a very specific niche that is unlikely to conflict with other skills. This is a clearly distinct technology stack. | 3 / 3 |
Total | 8 / 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 SDK reference skill with excellent actionability — nearly every section includes executable Java code with proper imports. The main weaknesses are the lack of validation checkpoints in the multi-step WebSocket workflow (e.g., verifying session creation before sending config/audio) and some unnecessary boilerplate sections ('When to Use', 'Limitations') that waste tokens without adding value. The content could be tightened by removing obvious advice and splitting detailed configuration into separate files.
Suggestions
Add explicit validation checkpoints in the Core Workflow — e.g., verify SESSION_CREATED event is received before sending configuration, and verify configuration acceptance before streaming audio.
Remove the generic 'When to Use' and 'Limitations' boilerplate sections, which provide no SDK-specific guidance and waste tokens.
Consider splitting Voice Configuration and Function Calling into separate reference files, keeping SKILL.md as a concise overview with links to detailed guides.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient with good code examples, but includes some unnecessary content like the 'Key Concepts' table describing obvious class names, the generic 'When to Use' and 'Limitations' boilerplate sections that add no value, and the 'Best Practices' section contains some obvious advice Claude would already know. | 2 / 3 |
Actionability | Provides fully executable Java code examples throughout — from Maven dependency, authentication, session setup, audio streaming, event handling, voice configuration, function calling, and error handling. All code is copy-paste ready with proper imports. | 3 / 3 |
Workflow Clarity | The core workflow is clearly numbered (1-4) with a logical sequence from session start through audio handling. However, there are no validation checkpoints — no verification that the session connected successfully before sending audio, no checks that configuration was accepted, and no feedback loop for error recovery in the main workflow. | 2 / 3 |
Progressive Disclosure | Content is reasonably structured with clear sections and a logical flow from installation to advanced features. However, the file is quite long (~200 lines of content) and could benefit from splitting detailed voice configuration and function calling into separate reference files. The reference links at the bottom are helpful but the inline content is borderline monolithic. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%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
76cbde3
- 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.