CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-speech-to-text

Transcribe audio to text using Azure AI Speech (Fast Transcription REST API). Use when converting audio/video to text, generating subtitles, or processing spoken content in OpenMontage. Optional cloud STT provider — preferred when AZURE_SPEECH_KEY is configured; the local faster-whisper `transcriber` is the default offline path.

71

Quality

89%

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

88%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.

The body is a lean, well-structured guide with executable code, concrete parameter guidance, explicit availability/fallback logic, and a verification tip. It respects Claude's competence (no concept padding) and its only weaknesses are a small amount of restated rationale and borderline-inline reference material (response schema, limits) at ~115 lines.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence: setup is two env-var exports, the pipeline example is a compact executable snippet, and parameters/response shape are covered in minimal space. Not anchor 5 because minor content could be trimmed — the "Why Fast Transcription (not Batch)" table's point is restated in prose ("needs no Blob storage, no SAS URLs, and no native SDK — just `requests` and the two env vars"), a small redundancy. It never drifts into explaining concepts Claude already knows.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready `stt.execute({...})` call with real paths and commented-out optional parameters, concrete bash exports for setup, specific parameter values ("`None` | `Masked` (default) | `Removed` | `Tags`"), an exact output JSON schema, and an explicit fallback instruction ("fall back to `transcriber` — its `execute` signature and output are identical"). The common case (transcribe a narration file into subtitle-ready segments) is covered end to end.

5 / 5

Workflow Clarity

This is a single-purpose skill with an unambiguous action, which per the rubric's simple-skill rule can score 5. Beyond that, it includes explicit checkpoints and an error-recovery loop: availability gating ("reports `AVAILABLE` once `AZURE_SPEECH_KEY` plus either `AZURE_SPEECH_REGION` or `AZURE_SPEECH_ENDPOINT` are set"), a `result.success` check, a documented fallback to `transcriber` on unavailability or error, and a verification tip ("Spot-check the first and last cues against the source audio"). Transcription is a read-only analysis operation, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the skill is self-contained with clean section headers, clearly signaled external doc links (Microsoft Learn), and no buried or nested references. This fits anchor 4 (good structure, content appropriately placed, minor gaps) rather than anchor 5: the simple-skill exception's "under 50 lines" criterion doesn't strictly apply to this ~115-line body, and sections like the full response JSON schema and the limits list could arguably live in a reference file — though keeping them inline at this size is a defensible choice.

4 / 5

Total

18

/

20

Passed

Description

87%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 description that clearly states what the skill does, when to use it, and how it relates to the alternative local transcriber. Trigger terms are natural and the explicit precedence guidance eliminates the main conflict risk; the only minor gap is a few missing synonyms/file extensions in the trigger list.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions: "Transcribe audio to text using Azure AI Speech (Fast Transcription REST API)", plus use-case actions "converting audio/video to text, generating subtitles". It stops short of anchor 5 because coverage of capabilities (e.g., diarization, language identification) is thinner than the comprehensive multi-action example, but it clearly exceeds anchor 3's "1-2 concrete actions" via the named API surface and subtitle generation.

4 / 5

Completeness

Both questions are explicitly answered: the "what" is "Transcribe audio to text using Azure AI Speech (Fast Transcription REST API)" and the "when" is a concrete "Use when converting audio/video to text, generating subtitles, or processing spoken content" clause. This matches the anchor-5 example pattern (what + explicit "Use when..." triggers) exactly; it additionally clarifies provider precedence, which anchor 4's weaker "when" would not.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "converting audio/video to text", "generating subtitles", "processing spoken content" — phrasings a user would actually say. Not anchor 5 because common synonyms and file formats are missing (e.g., "transcription", "speech-to-text", "captions", .mp3/.wav/.mp4), but coverage is good with only a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (Azure cloud STT) and explicitly disambiguates against the nearest competing skill: "Optional cloud STT provider — preferred when AZURE_SPEECH_KEY is configured; the local faster-whisper `transcriber` is the default offline path." This resolves the one realistic overlap (local transcription) directly, so conflict risk is minimal. Voice is third person throughout, so no specificity penalty applies.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

calesthio/OpenMontage

Path

.agents/skills/azure-speech-to-text/SKILL.md

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.