Microsoft
Install Azure AI
Pick your agent. Every command is ready to paste.
npx skills add microsoft/azure-skills --skill azure-aiThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads azure-ai when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the azure-ai skill”. In Codex, type $azure-ai.
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
Tips for Azure AI
- • Start a fresh session after installing so your agent picks up the new skill.
- • This skill ships scripts. Read them before the first run, and run it in a project without secrets first.
- • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Azure AI
What does the Azure AI skill do?
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.
How do I install Azure AI?
Run "npx skills add microsoft/azure-skills --skill azure-ai" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Azure AI work in Cursor and Codex?
Yes. Azure AI uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Azure AI free?
Azure AI is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Azure AI?
Azure AI is published by Microsoft in the microsoft/azure-skills repository, together with 29 other skills.
