azure-ai-voicelive-java
Azure AI VoiceLive SDK for Java. Real-time bidirectional voice conversations with AI assistants using WebSocket.
48
52%
Does it follow best practices?
Impact
—
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 clear and distinctive technology niche (Azure AI VoiceLive SDK for Java) but is too terse and lacks explicit trigger guidance. It reads more like a product tagline than a skill description that helps Claude decide when to use it. Adding a 'Use when...' clause and more concrete actions would significantly improve its utility for skill selection.
Suggestions
Add a 'Use when...' clause specifying triggers like 'Use when the user asks about Azure AI VoiceLive, real-time voice streaming in Java, WebSocket-based voice conversations, or building voice AI assistants with Azure.'
List specific concrete actions the skill covers, such as 'Set up WebSocket connections, configure voice pipelines, handle audio streaming, manage conversation sessions, and integrate Azure AI voice services in Java applications.'
Include additional natural trigger terms users might say, such as 'speech', 'audio streaming', 'voice chat', 'real-time audio', or 'Azure voice SDK'.
| 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. The technology stack and product name are highly distinctive. | 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 has executable Java code with proper imports. The main weaknesses are the lack of validation checkpoints integrated into the workflow (e.g., verifying session connection before sending config), some unnecessary boilerplate sections ('When to Use', 'Limitations'), and the monolithic structure that could benefit from splitting advanced topics into separate files.
Suggestions
Integrate validation checkpoints into the core workflow, e.g., verify session creation succeeded before sending configuration, and add error recovery guidance at each step.
Remove the generic 'When to Use' and 'Limitations' boilerplate sections — they add no SDK-specific value and waste tokens.
Consider splitting voice configuration variants and function calling into separate referenced files to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient with good code examples, but includes some unnecessary content like the 'Key Concepts' table describing things Claude can infer, the 'When to Use' and 'Limitations' boilerplate sections that add no value, and the 'Best Practices' list which is somewhat generic. The audio requirements table is useful but the overall document could be tighter. | 2 / 3 |
Actionability | Provides fully executable Java code for every step: installation via Maven, authentication (two methods), session creation, configuration, audio sending, 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 configuration, audio input, and event handling. However, there are no explicit validation checkpoints — no verification that the session connected successfully before proceeding, no guidance on what to do if configuration fails, and no feedback loop for error recovery in the main workflow. The error handling section is separate rather than integrated into the workflow. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear headers and sections, but it's a fairly long monolithic document (~200 lines of content). Voice configuration variants and function calling could be split into separate reference files. The reference links to GitHub are helpful but the document itself tries to cover everything inline. | 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
9e5d4dd
- 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.