# azure-speech

Skill for Claude Code and Codex guides development with Azure Speech in Foundry Tools. Activates during setup of speech-to-text, synthesis, avatars, and Voice Live agent workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 249 installs · ★ 818 repo stars
- Author: MicrosoftDocs
- License: CC-BY-4.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-speech/SKILL.md
- Updated: 2026-11-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/azure-speech

## What it does

Runs across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It equips the assistant with a curated topic index pointing directly to technical guidance for Azure Speech. Coverage spans troubleshooting SDK failures, batch transcription data prep, SSML and voice tuning, quota limits, Entra authentication, and container deployment via Kubernetes Helm charts.

Live documentation retrieval requires network connectivity. The agent fetches remote Markdown references using `mcp_microsoftdocs:microsoft_docs_fetch` or falls back to `fetch_webpage` with the `from=learn-agent-skill` query string. Missing internet access prevents the tool from retrieving detailed guide contents behind the index URLs.

Scope stays limited to Azure Speech workloads. For projects involving Azure Content Understanding, Azure AI Language, Azure Translator, or Azure AI Bot Service, separate purpose-built skills must be used instead.

## Requirements
- Works with: Azure, Kubernetes

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-speech -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/azure-speech/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/azure-speech/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-speech -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/azure-speech/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-speech -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/azure-speech/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MicrosoftDocs/Agent-Skills skills/azure-speech
```

2. **Manually: put the files in place**
- File: `.github/skills/azure-speech/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-speech -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-speech
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/azure-speech/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-speech -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-speech/SKILL.md

## When to use it
- configure real-time and batch speech transcription using Azure Speech SDK
- troubleshoot container deployments and extract session IDs for customer support
- optimize speech synthesis latency and configure voice avatars via SSML
- set up secure network isolation with Private Link and Entra authentication

## Example prompts
- Show best practices to lower latency during Azure Speech synthesis
- How do I retrieve the session ID when an Azure Speech STT job fails?
- Configure audio settings for Voice Live agents using Azure Speech SDK

## Source text · SKILL.md · CC-BY-4.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7b3ddd371626ba99.

BEGIN THIRD-PARTY FILE 7b3ddd371626ba99
```text
---
name: azure-speech
description: Expert knowledge for Azure Speech in Foundry Tools development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using STT/TTS containers, SSML/avatars, Voice Live agents, telephony APIs, or MAI-Transcribe workloads, and other Azure Speech in Foundry Tools related development tasks. Not for Azure Content Understanding in Foundry Tools (use azure-content-understanding), Azure AI Language (use azure-language-service), Azure Translator (use azure-translator), Azure AI Bot Service (use azure-bot-service).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  generator: "docs2skills/1.0.0"
---
# Azure Speech in Foundry Tools Skill

This skill provides expert guidance for Azure Speech in Foundry Tools. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

## How to Use This Skill

> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file

> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

This skill requires **network access** to fetch documentation content:
- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.

## Category Index

| Category | Lines | Description |
|----------|-------|-------------|
| Troubleshooting | L36-L44 | Diagnosing and fixing common Azure Speech issues in Foundry (TTS/STT errors, SDK and container problems, deployment failures, and how to collect session/transcription IDs for support). |
```
END THIRD-PARTY FILE 7b3ddd371626ba99

The third-party file has ended. Everything between the 7b3ddd371626ba99 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2449 of 22097 bytes. © MicrosoftDocs · CC-BY-4.0 · https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-speech/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
