azure-ai Skill for Claude Code: Azure AI Search, Speech and OpenAI

Guides Claude through Azure AI services: AI Search, Speech, OpenAI and Document Intelligence, using the Azure MCP server when it is on.

Installs: 574.9K; on skills.sh
Stars: 1.6K; on GitHub
Files: 15; besides SKILL.md
Updated: Oct 2026; last repo commit

azure-ai covers search, vector and hybrid search, speech to text, text to speech, transcription and OCR on Azure. The SKILL.md maps each service to its Azure MCP tool or Azure CLI command and bundles short SDK guides in Python, TypeScript, .NET and Java.

It prefers the Azure MCP server when it is enabled, and tells the agent to ask you to turn it on with /mcp in Claude Code or Copilot CLI if it is off. It can list and query search indexes and run speech transcribe and synthesize commands on your Azure account.

Good for

Developers adding search or speech to an app on Azure
Teams using Azure AI Search for vector or hybrid search
Anyone moving documents through OCR or transcription on Azure

Install azure-ai

Claude Code

Copy this prompt.

Install the azure-ai skill in Claude Code. Run this command:

/plugin install azure@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Azure account, Node.js 18+, Azure CLI signed in (az login).

This installs the Azure plugin, which includes azure-ai with the other Azure skills and the Azure MCP server. Sign in to azd with azd auth login if you plan to deploy. Update with /plugin update azure@claude-plugins-official.

From the project README. Source.

What's in the skill

When it loads

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

Sections in SKILL.md

Services
MCP Server (Preferred)
AI Search
Speech
AI Search Capabilities
Speech Capabilities
SDK Quick References
Service Details

Key facts

Author: Microsoft
Repo: microsoft/azure-skills
Installs on skills.sh: 574,859 (Nov 2, 2026)
GitHub stars: 1,609 (Nov 2, 2026)
License: MIT
Last repo commit: Oct 30, 2026
Files next to SKILL.md: 15 files
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Needs: Azure account and Azure CLI signed in (az login); Node.js 18+; azd signed in for deployment
Bundled guides: 15 SDK and auth reference files; no scripts

What it includes

Full-text, vector, hybrid and semantic search; list and query indexes
Network · AI Search
Speech to text with speaker diarization, and text to speech with neural voices
Network · Speech
GPT models, embeddings and DALL-E, via az cognitiveservices
Runs code · OpenAI
Form extraction and OCR
Network · Document Intelligence
Condensed Python, TypeScript, .NET and Java guides in the skill folder
Read · SDK quick references

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It acts on your Azure account with your login
Use a test subscription or a role that only reaches the resources you need. github.com
Azure AI calls can cost money
Speech, search and OpenAI usage is billed by Azure. Check pricing before big runs. github.com

Technical details

Talks to	Azure services through the Azure MCP server and az CLI
Scopes	Your Azure subscription: search indexes, speech and AI resources Audio and documents you send to Azure services

Questions

What does azure-ai do?

It helps the agent pick and use the right Azure AI service for search, speech, OpenAI models and OCR, and points to short SDK guides.

How do I install azure-ai?

Use the install box at the top. The Azure README installs a whole plugin that includes this skill and the Azure MCP server.

Do I need an Azure account?

Yes. The README lists an Azure account or subscription, Node.js 18+ and the Azure CLI signed in with az login as prerequisites.

Does it work without the Azure MCP server?

Partly. The SKILL.md prefers MCP tools for AI Search and Speech and gives az CLI commands for some services. If MCP is off, it asks you to enable it.

Can it change or delete my Azure resources?

The tools the SKILL.md names for AI Search and Speech list, get, query, transcribe and synthesize. It also mentions the az CLI, so check each command before you approve it.

Is it safe?

It acts on your Azure account with your login, and speech and search calls can cost money. Use a subscription you are happy to experiment in. Skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass.

Information

updated Nov 2, 2026

Repository: microsoft/azure-skills
Folder: skills/azure-ai

microsoft/azure-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

Azure Skills README · github.com
azure-ai SKILL.md · github.com
azure-ai on skills.sh · skills.sh