🎯

azure-ai

🎯Skill

A 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.

microsoft/azure-skills595,022 InstallsAdded Mar 4, 2026

Installation

$npx skills add microsoft/azure-skills --skill azure-ai

Run 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.

Run it (Claude Code)/azure-ai
Install 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__search commands like search_index_list and search_query.
  • Turn speech into text or text into speech with speech_transcribe and speech_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 /mcp in 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

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

ServiceUse WhenMCP ToolsCLI
AI SearchFull-text, vector, hybrid searchazure__searchaz search
SpeechSpeech-to-text, text-to-speech, SDK logsazure__speech-
OpenAIGPT models, embeddings, DALL-E-az cognitiveservices
Document IntelligenceForm 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

FeatureDescription
Full-text searchLinguistic analysis, stemming
Vector searchSemantic similarity with embeddings
Hybrid searchCombined keyword + vector
AI enrichmentEntity extraction, OCR, sentiment

Speech Capabilities

FeatureDescription
Speech-to-textReal-time and batch transcription
Text-to-speechNeural voices, SSML support
Speaker diarizationIdentify who spoke when
Custom modelsDomain-specific vocabulary
Client SDK diagnosticsSpeech 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:

Service Details

For deep documentation on specific services:

More from this repository10

🎯
microsoft-foundry🎯Skill

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.

🎯
azure-diagnostics🎯Skill

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🎯Skill

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🎯Skill

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🎯Skill

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🎯Skill

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🎯Skill

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.

🎯
azure-kusto🎯Skill

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.

🎯
azure-aigateway🎯Skill

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.

🎯
azure-messaging🎯Skill

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.