azure-ai
π―SkillA Microsoft skill that helps Claude build and fix apps that use Azure's AI services for search, speech, OpenAI models and reading text from documents. It picks the right service and tool for your task.
Installation
npx skills add microsoft/azure-skills --skill azure-aiRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/azure-aiInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/azure-ai/ - All projects
~/.claude/skills/azure-ai/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
What this skill does
Overview
This skill covers four Azure services: AI Search, Speech, OpenAI and Document Intelligence, which pulls text and fields out of forms and scans. When Azure MCP (a standard way to connect Claude to outside services) is turned on, it uses those tools first. It also links short SDK guides, which show how to call each service from your code.
Key Features
- List search indexes (the stored data a search looks through) and run keyword, meaning-based (vector) or combined (hybrid) searches with
azure__searchcommands likesearch_index_listandsearch_query. - Turn speech into text or text into speech with
speech_transcribeandspeech_synthesize. - Collect and read Speech SDK logs, including session and result IDs, without MCP or a login.
- Open quick SDK guides for AI Search, OpenAI, Vision, Translation, Document Intelligence and Content Safety in Python, TypeScript, .NET and Java.
- Learn how to turn on Azure MCP with
/mcpin Claude Code or Copilot CLI.
Who is this for?
It suits developers who add search, voice or document reading to an app on Azure. It also helps when a Speech SDK app fails and you need logs and session IDs to find the cause.
Summarized by AI from this skill's SKILL.md. Suggest a better one
SKILL.md
View on GitHub β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.
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__searchwith commandsearch_index_list- List search indexesazure__searchwith commandsearch_index_get- Get index detailsazure__searchwith commandsearch_query- Query search index
Speech
azure__speechwith commandspeech_transcribe- Speech to textazure__speechwith commandspeech_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 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 | TypeScript | .NET
- OpenAI: .NET
- Vision: Python | Java
- Transcription: Python
- Translation: Python | TypeScript
- Document Intelligence: .NET | TypeScript
- Content Safety: Python | TypeScript | Java
Service Details
For deep documentation on specific services:
- AI Search indexing and queries -> Azure AI Search documentation
- Speech transcription patterns -> Azure AI Speech documentation
- Speech SDK client logs and troubleshooting -> Speech SDK client diagnostics
More from this repository10
Helps you build, deploy, test, and manage AI agents and models on Microsoft Foundry, Microsoft's Azure service for AI. It guides the AI through each task with fixed steps.
Helps you find and fix problems in apps running on Azure, such as crashes, slow responses, or connection failures. It checks things in a set order and can work only from logs you provide.
azure-prepare gets a new or existing app ready to deploy to Azure with azd, Microsoft's command-line tool for Azure. It first writes a plan for your approval, then creates the setup files.
azure-deploy puts your app on Azure after the azure-prepare and azure-validate skills have prepared and checked it. It runs the deployment, recovers from errors, and gives you the live web addresses.
azure-validate checks your Azure app before you deploy it, so you can catch setup and permission problems early. It runs after azure-prepare and before azure-deploy.
azure-resource-lookup finds and lists your Azure resources, such as web apps, virtual machines, and storage accounts, across your subscriptions. It only reads data and never changes anything.
azure-resource-visualizer draws a diagram of an Azure resource group that shows how each resource connects to the others. It saves the diagram and notes in a markdown file.
Lets Claude search and summarize large amounts of logs and app data stored in Azure Data Explorer. You ask what you want to know, and it writes and runs the queries for you.
Helps you send all requests to your AI models and tools through Azure API Management, so you can control cost, block harmful content and limit traffic. It includes Azure command-line steps for setup and testing.
Helps you find and fix errors in apps that send and receive messages through Azure Event Hubs or Service Bus. It checks service health and Microsoft docs to suggest a fix.