Skip to content
Development
Skill

/azure-ai

Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, Speech SDK logs, session ID, result ID, OCR, convert text to speech.

From plugin
github-copilot-for-azure
26454 skills2 MCP

Claude Code

$ npx -y skills add microsoft/GitHub-Copilot-for-Azure --skill azure-ai --agent claude-code

SKILL.md

azure-ai.SKILL.md
name: azure-ai
description: "Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, Speech SDK logs, session ID, result ID, OCR, convert text to speech."
license: MIT
metadata:
  author: Microsoft
  version: "0.0.0-placeholder"

Azure AI Services

Services

| Service | Use When | MCP Tools | CLI | |---------|----------|-----------|-----| | AI Search | Full-text, vector, hybrid search | `azure__search` | `az search` | | Speech | Speech-to-text, text-to-speech, SDK logs | `azure__speech` | - | | OpenAI | GPT models, embeddings, DALL-E | - | `az cognitiveservices` | | Document Intelligence | Form extraction, OCR | - | - |

MCP Server (Preferred)

When Azure MCP is enabled:

AI Search

  • `azure__search` with command `search_index_list` - List search indexes
  • `azure__search` with command `search_index_get` - Get index details
  • `azure__search` with command `search_query` - Query search index

Speech

  • `azure__speech` with command `speech_transcribe` - Speech to text
  • `azure__speech` with command `speech_synthesize` - Text to speech

**If Azure MCP is not enabled:** In Copilot CLI or Claude Code, ask the user to run `/mcp` and enable Azure MCP; in other hosts, ask the user to enable Azure MCP through the host's MCP configuration.

AI Search Capabilities

| Feature | Description | |---------|-------------| | Full-text search | Linguistic analysis, stemming | | Vector search | Semantic similarity with embeddings | | Hybrid search | Combined keyword + vector | | AI enrichment | Entity extraction, OCR, sentiment |

Speech Capabilities

| Feature | Description | |---------|-------------| | Speech-to-text | Real-time and batch transcription | | Text-to-speech | Neural voices, SSML support | | Speaker diarization | Identify who spoke when | | Custom models | Domain-specific vocabulary | | Client SDK diagnostics | [Speech SDK client diagnostics](references/speech/diagnostics.md) for log collection, offline analysis, features, and session/result IDs (no MCP or login required) |

SDK Quick References

For programmatic access to these services, see the condensed SDK guides:

  • **AI Search**: [Python](references/sdk/azure-search-documents-py.md) | [TypeScript](references/sdk/azure-search-documents-ts.md) | [.NET](references/sdk/azure-search-documents-dotnet.md)
  • **OpenAI**: [.NET](references/sdk/azure-ai-openai-dotnet.md)
  • **Vision**: [Python](references/sdk/azure-ai-vision-imageanalysis-py.md) | [Java](references/sdk/azure-ai-vision-imageanalysis-java.md)
  • **Transcription**: [Python](references/sdk/azure-ai-transcription-py.md)
  • **Translation**: [Python](references/sdk/azure-ai-translation-text-py.md) | [TypeScript](references/sdk/azure-ai-translation-ts.md)
  • **Document Intelligence**: [.NET](references/sdk/azure-ai-document-intelligence-dotnet.md) | [TypeScript](references/sdk/azure-ai-document-intelligence-ts.md)
  • **Content Safety**: [Python](references/sdk/azure-ai-contentsafety-py.md) | [TypeScript](references/sdk/azure-ai-contentsafety-ts.md) | [Java](references/sdk/azure-ai-contentsafety-java.md)

Service Details

For deep documentation on specific services:

  • AI Search indexing and queries -> [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search)
  • Speech transcription patterns -> [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview)
  • Speech SDK client logs and troubleshooting -> [Speech SDK client diagnostics](references/speech/diagnostics.md)
Read more
@microsoft
Ships withgithub-copilot-for-azure

GitHub Copilot for Azure is a set of extensions for Visual Studio, VS Code, and Claude Code designed to streamline the process of developing for Azure.

26454 skills2 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
264
Star history of microsoft/GitHub-Copilot-for-Azure on GitHub, a chart by star-history.com

Other skills on github-copilot-for-azure.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about azure-ai.

Which coding agents can use azure-ai?
azure-ai installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.