azure-ai-transcription-py
Azure AI Transcription SDK for Python. Use for real-time and batch speech-to-text transcription with timestamps and diarization.
85
82%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-crafted skill description that concisely communicates the specific domain (Azure AI speech-to-text), the language/SDK context (Python), and concrete capabilities (real-time, batch, timestamps, diarization). The 'Use for...' clause provides clear trigger guidance. The description is concise without being vague, and uses appropriate third-person voice.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'real-time and batch speech-to-text transcription with timestamps and diarization.' These are concrete, well-defined capabilities rather than vague language. | 3 / 3 |
Completeness | Clearly answers both what ('Azure AI Transcription SDK for Python' doing 'real-time and batch speech-to-text transcription with timestamps and diarization') and when ('Use for...' provides explicit trigger guidance for when to select this skill). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Azure', 'transcription', 'speech-to-text', 'timestamps', 'diarization', 'real-time', 'batch', 'Python', 'SDK'. These cover the main terms a user working in this domain would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: Azure-specific, Python-specific, speech-to-text transcription. The combination of platform (Azure), language (Python), and domain (speech-to-text with diarization) makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 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.
The skill provides solid, actionable code examples for Azure AI Transcription covering the core use cases (batch and real-time). However, it's weakened by boilerplate sections ('When to Use', 'Limitations') that waste tokens, generic best practices, and a lack of error handling or validation steps for batch operations. The content would benefit from trimming filler and adding error recovery guidance.
Suggestions
Remove the boilerplate 'When to Use' and 'Limitations' sections, which are generic filler that don't add SDK-specific value.
Add error handling and validation to the batch transcription workflow (e.g., checking job.status for failure, retry logic, handling common errors like invalid URLs or auth failures).
Trim the 'Best Practices' list to only non-obvious, SDK-specific guidance—remove items like 'specify language' that Claude would already know.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with good code examples, but the 'Best Practices' section contains some generic advice Claude would already know (e.g., 'specify language to improve accuracy'), and the 'When to Use' and 'Limitations' sections are boilerplate filler that add no real value. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready code for authentication, batch transcription, and real-time streaming. Includes concrete installation commands and environment variable setup. | 3 / 3 |
Workflow Clarity | The batch transcription shows a clear sequence (create job → get result → check status), but there's no error handling, no validation of results, and no guidance on what to do if transcription fails or returns unexpected status. For a batch operation, missing feedback loops cap this at 2. | 2 / 3 |
Progressive Disclosure | Content is reasonably organized with clear section headers, but everything is inline in a single file. For an SDK skill covering both real-time and batch modes plus diarization and timestamps, advanced topics like error handling, output format details, and diarization configuration could be split into referenced files. | 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.