SkillAgentSearch skills...

azure-ai

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

Install / Use

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

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

80/100

Category

Operations

Supported Platforms

Universal

Our assessment of azure-ai

azure-ai scores 80/100 on our quality scale, 684th of 762 Operations skills we index.

Its SKILL.md is 4.5 KB long, split into 5 sections and no code examples: a solid amount of guidance for an agent.

With 1,496 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
11/20
Description
15/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so azure-ai is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

azure-ai compared with similar skills

All 4 of these similar skills score higher than azure-ai; compare them before choosing.

SkillScoreStarsUpdatedFormat
azure-ai (this skill)by microsoft801.5k57d agoSKILL.md
LocalAIby mudler10050.5ktodayMCP Server
algorithmic-artby anthropics100177.9k58d agoSKILL.md
pptxby anthropics100177.9k58d agoSKILL.md
prospectingby coreyhaines3110060.1k8d agoSKILL.md

Frequently asked questions

How do I install azure-ai?
Run npx skills add microsoft/azure-skills --skill azure-ai. The install tabs above show the steps for each supported agent.
Which AI agents does azure-ai work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is azure-ai safe to use?
It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is azure-ai still maintained?
The repository was last updated about 2 months ago, so azure-ai is actively maintained.

name: azure-ai description: "Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Translator, Content Safety, and OpenAI apps. WHEN: AI Search, vector search, hybrid search, semantic search, indexer, speech-to-text, text-to-speech, transcribe, fast or batch transcription, Speech SDK logs, session ID, result ID, OCR, document translation, glossary." license: MIT metadata: author: Microsoft version: "1.2.5"

Azure AI Services

Scope and Handoffs

| Request Scope | Route To | |---------------|----------| | Foundry projects, agents (Prompt/Hosted/Voice), model deployments, fine-tuning, quota, RBAC, Foundry VNet | microsoft-foundry | | Foundry IQ knowledge bases and connectors | foundry-iq (separate foundry-iq-skills plugin; if absent, say so) | | Azure API Management AI Gateway policies (llm-content-safety, semantic cache, token limits) | azure-aigateway | | Classic AI Search, Speech SDK/REST/batch, Document Intelligence, Translator, standalone Content Safety, OpenAI SDK | Stay in azure-ai |

Services and Diagnostic Workflows

Read the matching reference before diagnosing errors, validating local inputs, or collecting support evidence:

| Service | MCP / CLI | Preflight & Diagnostics | |---------|-----------|-------------------------| | AI Search (classic indexes, vector/hybrid/semantic queries, indexers/skillsets) | azure__search (search_index_list, search_index_get, search_query), az search | Index, query, and indexer diagnostics | | Speech (STT, TTS, Fast/Batch Transcription, Batch Synthesis, SDK logs) | azure__speech (speech_transcribe, speech_synthesize), az cognitiveservices | Speech SDK client diagnostics | Audio & REST/batch preflight | | Document Intelligence (v4.0 Analyze, layout/OCR, custom labels) | az cognitiveservices | Input, v4 migration, and Analyze diagnostics | | Translator (Text & Document Translation, glossaries, Blob auth) | az cognitiveservices | Document Translation & glossary preflight | | Content Safety (standalone text:analyze, image:analyze, text:shieldPrompt, blocklists) | az cognitiveservices | Standalone API preflight & diagnostics | | OpenAI (direct SDK/API usage) | az cognitiveservices | .NET SDK |

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. Offline local preflight scripts do not require Azure MCP or Azure sign-in.

For keyless authentication patterns across Azure AI SDKs, read Azure Authentication Best Practices.

SDK Quick References

Service Documentation

Related Skills

View on GitHub
GitHub Stars1.5k
CategoryOperations
Updated1mo ago
Forks249

Languages

Shell

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions