How do I install the Azure AI skill?

Run npx skillmds@latest add jonathan-vella/azure-ai in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Azure AI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Azure AI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Azure AI free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Azure AI?

jonathan-vella (@jonathan-vella) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Azure AI by jonathan-vella — Agent Skill

Name: Azure AI
Author: jonathan-vella

Azure AI

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.

File contents

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	`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__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

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

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

Reference Index

Load these on demand — do NOT read all at once:

Reference	When to Load
`references/auth-best-practices.md`	Auth Best Practices

---name: azure-aidescription: 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---# 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 | `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__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| 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 |## SDK Quick ReferencesFor programmatic access to these services, see the condensed SDK guides:- **AI Search**: [Python](references/sdk/azure-search-documents-py.md) | [TypeScript](references/sdk/azure-search-documents-ts.md) | [.NET](references/sdk/azure-search-documents-dotnet.md)- **OpenAI**: [.NET](references/sdk/azure-ai-openai-dotnet.md)- **Vision**: [Python](references/sdk/azure-ai-vision-imageanalysis-py.md) | [Java](references/sdk/azure-ai-vision-imageanalysis-java.md)- **Transcription**: [Python](references/sdk/azure-ai-transcription-py.md)- **Translation**: [Python](references/sdk/azure-ai-translation-text-py.md) | [TypeScript](references/sdk/azure-ai-translation-ts.md)- **Document Intelligence**: [.NET](references/sdk/azure-ai-document-intelligence-dotnet.md) | [TypeScript](references/sdk/azure-ai-document-intelligence-ts.md)- **Content Safety**: [Python](references/sdk/azure-ai-contentsafety-py.md) | [TypeScript](references/sdk/azure-ai-contentsafety-ts.md) | [Java](references/sdk/azure-ai-contentsafety-java.md)## Service DetailsFor deep documentation on specific services:- AI Search indexing and queries -> [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search)- Speech transcription patterns -> [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview)## Reference IndexLoad these on demand — do NOT read all at once:| Reference | When to Load || ----------------------------------- | ------------------- || `references/auth-best-practices.md` | Auth Best Practices |

Frequently asked questions