BACK TO SKILLS
docs-writingany

Azure Ai

Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps.

At a glance

Not tested yet
GitHub stars
1,658
Last commit
2026-11-19
Licence
MIT
Install
npx skills add https://github.com/microsoft/azure-skills --skill azure-ai
Stats checked 2026-11-19

Azure Ai

What it does

Azure AI is a skill for coding agents that covers Azure AI Search, Speech, Document Intelligence, Translator, Content Safety, and direct OpenAI SDK usage. It gives the agent workflows and diagnostics for building and troubleshooting apps on these services. It is for developers working with Azure AI services who want their agent to handle setup, validation, and error diagnosis.

Claude Code plugin discovery showing the Azure plugin
Image: microsoft/azure-skills (MIT)

Key features

  • Covers AI Search indexes, vector, hybrid, and semantic queries, and indexers and skillsets.
  • Covers Speech speech-to-text, text-to-speech, Fast and Batch Transcription, Batch Synthesis, and SDK logs.
  • Covers Document Intelligence v4.0 Analyze, layout and OCR, and custom labels.
  • Covers Translator Text and Document Translation, glossaries, and Blob auth.
  • Covers standalone Content Safety text:analyze, image:analyze, text:shieldPrompt, and blocklists.
  • Routes Foundry projects, agents, and model deployments to microsoft-foundry, and API Management AI Gateway policies to azure-aigateway.
  • Includes SDK quick references for Python, TypeScript, .NET, Java, and Go across the services.

Quick start

npx skills add https://github.com/microsoft/azure-skills --skill azure-ai
  1. Make sure you have an Azure account or subscription, Node.js 18+ on your PATH, and the Azure CLI installed and authenticated with az login.
  2. Install the skill.
  3. If Azure MCP is not enabled, run /mcp in Copilot CLI or Claude Code and enable Azure MCP, or enable it through your host's MCP configuration.

Example prompts

  • Create an AI Search index with vector and semantic search and run a hybrid query against it.
  • Transcribe this audio file and show me the Speech SDK logs if it fails.
  • Run OCR on this PDF with Document Intelligence and explain any errors.
  • Translate this document into French using a glossary.

What to watch out for

  • You need an Azure account or subscription.
  • Node.js 18+ must be on your PATH because npx starts the MCP servers.
  • The Azure CLI must be installed and authenticated with az login.
  • The Azure Developer CLI must be installed and authenticated with azd auth login if you plan to use deployment workflows.
  • If Azure MCP is not enabled, you must enable it through your host before the agent can act on live resources.
  • Foundry IQ knowledge bases require a separate foundry-iq-skills plugin; if it is absent, the skill says so.

Not tested by tools4agents yet. Read the SKILL.md and any scripts in the source repository before you install it.

skills.sh counted 8637 installs on 2026-11-18.

GitHub SourceGitHub Stars
Last verified 2026-11-18

Similar tools