PluginBench
Skill
Official
Pass
Audit score 90

azure-ai

microsoft/azure-skills

Access Azure AI Search, Speech, OpenAI, and Document Intelligence services for search, transcription, and OCR.

SourceView on skills.sh

What is azure-ai?

Integrates Azure AI services including AI Search (full-text, vector, hybrid), Speech (transcription, text-to-speech), OpenAI models, and Document Intelligence. Use when you need semantic search, speech processing, embeddings, or form/document extraction.

  • Query AI Search indexes with full-text, vector, and hybrid search
  • Transcribe speech to text and synthesize text to speech with neural voices
  • Extract data from forms and documents with OCR
  • List and retrieve search index details
  • Support speaker diarization and custom speech models
  • Access GPT models and embeddings via Azure OpenAI

How to install azure-ai

npx skills add https://github.com/microsoft/azure-skills --skill azure-ai
Prerequisites
  • Azure subscription with AI Search, Speech, or Document Intelligence resources provisioned
  • Azure MCP server enabled (or run `/azure:setup` to configure)
  • Appropriate Azure credentials and service endpoints configured
Claude Code
Cursor
Windsurf
Cline

How to use azure-ai

  1. 1.Install the skill via `npx skills add https://github.com/microsoft/azure-skills --skill azure-ai`
  2. 2.Enable Azure MCP via `/mcp` or run `/azure:setup` if not already enabled
  3. 3.Use `azure__search` tools to list indexes, get details, or query with `search_query`
  4. 4.Use `azure__speech` tools to transcribe audio with `speech_transcribe` or generate speech with `speech_synthesize`
  5. 5.Reference SDK guides for programmatic access in Python, TypeScript, .NET, or Java

Use cases

Good for
  • Build semantic search over document collections using vector embeddings
  • Transcribe audio files or real-time speech input for accessibility or analysis
  • Extract structured data from scanned forms or PDFs
  • Implement hybrid search combining keyword matching with semantic similarity
  • Generate speech output with multiple neural voices and SSML support
Who it's for
  • Backend developers integrating Azure AI services
  • Search engineers building semantic or vector search
  • Applications requiring speech-to-text or text-to-speech
  • Document processing and data extraction workflows
  • Teams using Azure cloud infrastructure

azure-ai FAQ

What's the difference between full-text, vector, and hybrid search?

Full-text search uses linguistic analysis and stemming for keyword matching. Vector search finds semantic similarity using embeddings. Hybrid search combines both approaches for better relevance.

Do I need to enable Azure MCP to use this skill?

Yes, Azure MCP must be enabled. If not already active, run `/azure:setup` or enable it via `/mcp`.

Can I use custom speech models?

Yes, the Speech service supports custom models for domain-specific vocabulary and improved accuracy.

What document formats does Document Intelligence support?

Document Intelligence handles forms, PDFs, and scanned documents for structured data extraction and OCR.

Which programming languages are supported?

SDK references are provided for Python, TypeScript, .NET, and Java for programmatic access to all services.

Full instructions (SKILL.md)

Source of truth, from microsoft/azure-skills.


name: azure-ai description: "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." license: MIT metadata: author: Microsoft version: "1.2.1"

Azure AI Services

Services

ServiceUse WhenMCP ToolsCLI
AI SearchFull-text, vector, hybrid searchazure__searchaz search
SpeechSpeech-to-text, text-to-speechazure__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: Run /azure:setup or enable via /mcp.

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

SDK Quick References

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

Service Details

For deep documentation on specific services: